CertEnumSubjectInSortedCTL 関数 (wincrypt.h)
CertEnumSubjectInSortedCTL 関数は、並べ替えられた証明書信頼リスト (CTL) 内の最初または次の TrustedSubject を取得します。 並べ替えられた CTL は、CERT_CREATE_CONTEXT_SORTED_FLAGセットで作成された CTL です。 ループで使用されるこの関数は、並べ替えられた CTL 内のすべての TrustedSubjects を順番に取得できます。
構文
BOOL CertEnumSubjectInSortedCTL(
[in] PCCTL_CONTEXT pCtlContext,
[in, out] void **ppvNextSubject,
[out] PCRYPT_DER_BLOB pSubjectIdentifier,
[out] PCRYPT_DER_BLOB pEncodedAttributes
);
パラメーター
[in] pCtlContext
検索する CTL_CONTEXT 構造体へのポインター。
[in, out] ppvNextSubject
最後に見つかった TrustedSubject のアドレスへのポインター。 列挙を開始するには、 ppvNextSubject が NULL に設定されたポインターを指している必要があります。 返されると、 ppvNextSubject によってアドレス指定されたポインターが、エンコードされたシーケンス内の次の TrustedSubject を指すように更新されます。
[out] pSubjectIdentifier
TrustedSubject を一意に識別する、 CRYPT_DER_BLOB 構造体へのポインター。 この構造体の情報には、ハッシュまたは任意の一意のバイト シーケンスを指定できます。
[out] pEncodedAttributes
バイト数と TrustedSubject のエンコードされた属性へのポインターを含む CRYPT_DER_BLOB構造体への ポインター。
戻り値
関数が成功した場合、戻り値は TRUE で、 ppvNextSubject はエンコードされたシーケンス内の次の TrustedSubject を指すように更新されます。
関数が失敗した場合、戻り値は FALSE になります。 サブジェクトがこれ以上ない場合、または無効な引数がある場合、戻り値は FALSE です。
解説
CRYPT_DER_BLOB構造体の pbData メンバーは、エンコードされたバイトを直接指します。 CRYPT_DER_BLOB構造体自体は、アプリケーションによって割り当てられ、解放される必要がありますが、これらの構造体の pbData メンバーによってアドレス指定されたメモリはアプリケーションによって割り当てられず、アプリケーションによって解放される必要はありません。
CERT_CREATE_CONTEXT_SORTED_FLAG フラグが設定された状態で CTL が並べ替えられない場合は、エラーが発生します。
要件
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | wincrypt.h |
| Library | Crypt32.lib |
| [DLL] | Crypt32.dll |