Edit

CTL_FIND_SUBJECT_PARA structure (wincrypt.h)

  • Article

The CTL_FIND_SUBJECT_PARA structure contains data used by CertFindCTLInStore with a dwFindType parameter of CTL_FIND_SUBJECT to find a Certificate Trust List (CTL).

Syntax

typedef struct _CTL_FIND_SUBJECT_PARA {
  DWORD                cbSize;
  PCTL_FIND_USAGE_PARA pUsagePara;
  DWORD                dwSubjectType;
  void                 *pvSubject;
} CTL_FIND_SUBJECT_PARA, *PCTL_FIND_SUBJECT_PARA;

Members

cbSize

The size, in bytes, of this structure.

pUsagePara

A pointer to a CTL_FIND_USAGE_PARA structure. Can be NULL if there is no need to reference the CTL_FIND_USAGE_PARA parameters when finding a CTL.

dwSubjectType

For CTL_CERT_SUBJECT_TYPE, the pvSubject member points to a CERT_CONTEXT. The CTL's SubjectAlgorithm is examined to determine the representation of the subject's identity. Initially, only SHA1 or MD5 hash will be supported. The appropriate hash property is obtained from the CERT_CONTEXT.

For CTL_ANY_SUBJECT_TYPE, pvSubject points to the CTL_ANY_SUBJECT_INFO structure that contains the SubjectAlgorithm to be matched in the CTL and the SubjectIdentifier to be matched in one of the CTL entries.

pvSubject

The value of the pvSubject member depends upon the value of the dwSubjectType member. For more information, see dwSubjectType.

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_ANY_SUBJECT_INFO

CTL_FIND_USAGE_PARA

CertFindCTLInStore