CertEnumCTLsInStore 関数 (wincrypt.h)

[アーティクル]
08/27/2023

CertEnumCTLsInStore 関数は、証明書ストア内の最初または次の証明書信頼リスト (CTL) コンテキストを取得します。ループで使用されるこの関数は、証明書ストア内のすべての CTL コンテキストを順番に取得できます。

構文

PCCTL_CONTEXT CertEnumCTLsInStore(
  [in] HCERTSTORE    hCertStore,
  [in] PCCTL_CONTEXT pPrevCtlContext
);

パラメーター

[in] hCertStore

証明書ストアのハンドル。

[in] pPrevCtlContext

見つかった前の CTL_CONTEXT 構造体へのポインター。ストア内の最初の CTL を取得するには 、NULL にする必要があります。連続する CCTL は、 pPrevCtlContext を前の呼び出しによって返されたポインターに設定することによって列挙されます。この関数は、このパラメーターの NULL 以外の値によって参照されるCTL_CONTEXTを解放します。列挙は、 CertDeleteCTLFromStore によって以前に削除されたすべての CCTL をスキップします。

戻り値

関数が成功した場合、戻り値は読み取り専用のCTL_CONTEXTへのポインターです。

関数が失敗し、CTL が見つからない場合、戻り値は NULL になります。拡張エラー情報については、 GetLastError を呼び出します。

考えられるエラーコードの一部を次に示します。

リターンコード	説明
CRYPT_E_NOT_FOUND	ストアに CCTL が存在しないか、関数がストアのリストの末尾に達しました。
E_INVALIDARG	hCertStore パラメーターのハンドルは、pPrevCtlContext パラメーターが指す CTL コンテキストのハンドルと同じではありません。

注釈

返されたポインターは、後続の呼び出しで pPrevCtlContext として渡されると解放されます。それ以外の場合は、 CertFreeCTLContext を呼び出してポインターを明示的に解放する必要があります。 NULL ではない pPrevCtlContext は、エラーの場合でも、(CertFreeCTLContext の呼び出しを介して) この関数によって常に解放されます。

複製は、 CertDuplicateCTLContext を呼び出すことによって行うことができます。

要件

要件	値
サポートされている最小のクライアント	Windows XP [デスクトップアプリ \| UWP アプリ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップアプリのみ \| UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	wincrypt.h
Library	Crypt32.lib
[DLL]	Crypt32.dll