CTL_FIND_SUBJECT_PARA structure (wincrypt.h)
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 |