CTL_FIND_SUBJECT_PARA

The CTL_FIND_SUBJECT_PARA structure is used by CertFindCTLInStore with a dwFindType of CTL_FIND_SUBJECT.

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

Members

cbSize

Count of bytes in this data structure.

pUsagePara

Pointer to a CTL_FIND_USAGE_PARA data structure. If there is no need to reference the CTL_FIND_USAGE_PARA parameters when finding a CTL, NULL may be specified.

dwSubjectType

For CTL_CERT_SUBJECT_TYPE, pvSubject 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 which contains the SubjectAlgorithm to be matched in the CTL and the SubjectIdentifer to be matched in one of the CTL entries.

pvSubject

pvSubject depends on the dwSubjectType. See dwSubjectType for details.

See Also

CERT_CONTEXT, CTL_ANY_SUBJECT_INFO, CTL_FIND_USAGE_PARA, CertFindCTLInStore