CertEnumCTLsInStore 関数 (wincrypt.h)
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 を呼び出します。
考えられるエラー コードの一部を次に示します。
| リターン コード | 説明 |
|---|---|
|
ストアに CCTL が存在しないか、関数がストアのリストの末尾に達しました。 |
|
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 |