CTL_VERIFY_USAGE_STATUS

The CTL_VERIFY_USAGE_STATUS structure is used by CertVerifyCTLUsage to return the CTL containing the subject, the subject's index into the CTL's array of entries, and the signer of the CTL.

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

Members

cbSize: The count of bytes in this data structure.
Upon input to CertVerifyCTLUsage, cbSize must be set to a size >= sizeof(CTL_VERIFY_USAGE_STATUS). Otherwise, CertVerifyCTLUsage returns FALSE and sets LastError to E_INVALIDARG.
dwError: If FALSE is returned by CertVerifyCTLUsage, dwError specifies the error status. LastError as reported from CertVerifyCTLUsage is also set to this error status. See the table in the "Return Values" section in CertVerifyCTLUsage for the list of error values.
dwFlags: CERT_VERIFY_UPDATED_CTL_FLAG indicates that the time invalid CTL in the store was updated with a new CTL.
ppCtl: On input, ppCtl can be null indicating that the caller is not interested in obtaining the CTL containing the subject. On output, *ppCtl is a pointer to the returned CTL containing the subject.
Returned contexts must be freed via the store's free context APIs.
dwCtlEntryIndex: Returns the subject's index into the CTL's array of entries.
ppSigner: On input, ppSigner can be null indicating that the caller is not interested in obtaining the signer of the CTL. On output, *ppSigner is a pointer to the returned signer of the CTL.
Returned contexts must be freed via the store's free context APIs.
dwSignerIndex: A message might have more than one signer. dwSignerIndex is the index of the signer that was actually used.

CTL_VERIFY_USAGE_STATUS

Members

See Also