CertEnumSubjectInSortedCTL

ソートされた証明書信頼リスト (CTL) 内の最初または次の TrustedSubject を取得する。

CertEnumSubjectInSortedCTL pCtlContext, ppvNextSubject, pSubjectIdentifier, pEncodedAttributes

pCtlContext : [var] 検索対象の CTL_CONTEXT 構造体へのポインター。
ppvNextSubject : [var] 直前に見つかった TrustedSubject のアドレスへのポインター。列挙を開始するには、ppvNextSubject は NULL に設定されたポインターを指していなければならない。戻り時、ppvNextSubject が指すポインターは、エンコードシーケンス内の次の TrustedSubject を指すように更新される。
pSubjectIdentifier : [var] TrustedSubject を一意に識別する CRYPT_DER_BLOB 構造体へのポインター。この構造体の情報はハッシュまたは任意の一意なバイト列でよい。
pEncodedAttributes : [var] バイト数と、TrustedSubject のエンコード済み属性へのポインターを含む CRYPT_DER_BLOB 構造体へのポインター。

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

解説

ソートされた証明書信頼リスト (CTL) 内の最初または次の TrustedSubject を取得する。

[戻り値]
関数が成功した場合、戻り値は TRUE で、ppvNextSubject はエンコードシーケンス内の次の TrustedSubject
を指すように更新される。関数が失敗した場合、戻り値は FALSE。これ以上サブジェクトがない場合、または引数が無効な場合も FALSE
になる。

[備考]
CRYPT_DER_BLOB 構造体の pbData メンバーは、エンコードされたバイト列を直接指している。CRYPT_DER_BLOB
構造体自体はアプリケーションが割り当てて解放しなければならないが、これらの構造体の pbData
メンバーが指すメモリはアプリケーションが割り当てたものではなく、アプリケーションが解放してはならない。CTL が
CERT_CREATE_CONTEXT_SORTED_FLAG フラグを指定してソートされていない場合、エラーが発生する。

情報