CTL_VERIFY_USAGE_STATUS structure (wincrypt.h)

The CTL_VERIFY_USAGE_STATUS structure contains information about a Certificate Trust List (CTL) returned by CertVerifyCTLUsage.

Syntax

typedef struct _CTL_VERIFY_USAGE_STATUS {
  DWORD          cbSize;
  DWORD          dwError;
  DWORD          dwFlags;
  PCCTL_CONTEXT  *ppCtl;
  DWORD          dwCtlEntryIndex;
  PCCERT_CONTEXT *ppSigner;
  DWORD          dwSignerIndex;
} CTL_VERIFY_USAGE_STATUS, *PCTL_VERIFY_USAGE_STATUS;

Members

cbSize

The size, in bytes, of the structure. The application calling CertVerifyCTLUsage sets this parameter. If cbSize is not greater than or equal to the required size of the structure, CertVerifyCTLUsage returns FALSE and GetLastError returns E_INVALIDARG.

dwError

The error status, if any, returned by the call to CertVerifyCTLUsage. For the list of possible error values, see the Return Values section in CertVerifyCTLUsage.

dwFlags

If CERT_VERIFY_UPDATED_CTL_FLAG is returned, CertVerifyCTLUsage updated a CTL whose time was no longer valid with a new, time-valid CTL.

ppCtl

Pointer to a pointer to a CTL context containing the matched subject. The calling application can set this pointer to NULL to indicate that a CTL containing the subject is not to be returned.

If ppCtl is not NULL, the calling application must free the returned context using CertFreeCTLContext.

dwCtlEntryIndex

Returns the array location of the matching subject's entry in the CTL's array.

ppSigner

A pointer to a pointer to the certificate context of the signer of the CTL. This pointer can be set to NULL by the calling application indicating that the certificate of the signer of the CTL is not to be returned.

If ppSigner is not NULL, the calling application must free the returned context using CertFreeCTLContext.

dwSignerIndex

Index of the signer actually used. Needed if a message has more than one signer.

Remarks

The members dwError, dwFlags, dwCtlEntryIndex, and dwSignerIndex should be initialized to zero by the calling application.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Header wincrypt.h

See also

CERT_CONTEXT

CTL_CONTEXT

CertVerifyCTLUsage