次の方法で共有


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 を呼び出します。

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

リターン コード 説明
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

こちらもご覧ください

CTL_CONTEXT

CertDeleteCTLFromStore

CertDuplicateCTLContext

CertFindCTLInStore

CertFreeCTLContext

証明書信頼リスト関数