CertFindSubjectInCTL

CertFindSubjectInCTL 関数は、証明書信頼リスト (CTL) 内から指定したサブジェクトを見つけることを試みる。

CertFindSubjectInCTL dwEncodingType, dwSubjectType, pvSubject, pCtlContext, dwFlags

dwEncodingType : [int] 使用するエンコード種別を指定する。現在は X509_ASN_ENCODING と PKCS_7_ASN_ENCODING のみが使用されているが、将来はエンコード種別が追加される可能性がある。現在のどちらのエンコード種別にも次を使用する: X509_ASN_ENCODING | PKCS_7_ASN_ENCODING。
dwSubjectType : [int] CTL 内で検索するサブジェクトの種別を指定する。既定の検索を行う場合は NULL でもよい。
pvSubject : [intptr] dwSubjectType パラメーターと組み合わせて使用するポインター。
pCtlContext : [var] 検索対象の CTL_CONTEXT 構造体へのポインター。
dwFlags : [int] 将来の使用のために予約されている。0 でなければならない。

(プラグイン / モジュール : crypt32.dll)

解説

CertFindSubjectInCTL 関数は、証明書信頼リスト (CTL) 内から指定したサブジェクトを見つけることを試みる。

[戻り値]
関数が成功した場合、戻り値は見つかったエントリ。関数が失敗した場合、戻り値は NULL。拡張エラー情報は GetLastError
を呼び出して取得する。想定されるエラーコードを以下に示す。
（以下省略）

[備考]
サブジェクトエントリの検索では、証明書のハッシュまたは CTL_ANY_SUBJECT_INFO 構造体の
SubjectIdentifier メンバーがキーとして使用される。キーとエントリの SubjectIdentifier
との間でバイナリメモリ比較が行われる。

情報