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 |