Edit

Share via

CTL_VERIFY_USAGE_PARA structure (wincrypt.h)

  • Article

The CTL_VERIFY_USAGE_PARA structure contains parameters used by CertVerifyCTLUsage to establish the validity of a CTL's usage.

Syntax

typedef struct _CTL_VERIFY_USAGE_PARA {
  DWORD           cbSize;
  CRYPT_DATA_BLOB ListIdentifier;
  DWORD           cCtlStore;
  HCERTSTORE      *rghCtlStore;
  DWORD           cSignerStore;
  HCERTSTORE      *rghSignerStore;
} CTL_VERIFY_USAGE_PARA, *PCTL_VERIFY_USAGE_PARA;

Members

cbSize

Size of this structure in bytes.

ListIdentifier

BLOB that specifies a ListIdentifier of a CTL to be found or verified. Normally the cbData member of the ListIdentifier BLOB will be zero, indicating that a CTL with any ListIdentifier can be a match.

To match only CTLs with no ListIdentifier, the cbData member of the ListIdentifier BLOB is set to CTL_FIND_NO_LIST_ID_CBDATA.

If an issuer creates multiple CTLs for the same SubjectUsage, a ListIdentifier can distinguish among them.

cCtlStore

The count of stores to be searched for a matching CTL.

rghCtlStore

Array of handles of stores to be searched to find a matching CTL.

cSignerStore

Count of stores to be searched for acceptable CTL signers.

rghSignerStore

Array of handles of stores to be searched for acceptable CTL signers.

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

CertVerifyCTLUsage