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

関連項目

CTL_CONTEXT

CertFindSubjectInSortedCTL

証明書と証明書ストアのメンテナンス機能