CertEnumCRLsInStore 関数 (wincrypt.h)

  • [アーティクル]

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

構文

PCCRL_CONTEXT CertEnumCRLsInStore(
  [in] HCERTSTORE    hCertStore,
  [in] PCCRL_CONTEXT pPrevCrlContext
);

パラメーター

[in] hCertStore

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

[in] pPrevCrlContext

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

戻り値

関数が成功した場合、戻り値はストア内の次の CRL_CONTEXT へのポインターです。

関数が失敗した場合、NULL が返されます。 拡張エラー情報については、 GetLastError を呼び出します。 考えられるエラー コードの一部を次に示します。

リターン コード 説明
E_INVALIDARG
 hCertStore パラメーターのハンドルは、pPrevCrlContext が指す証明書コンテキストのハンドルと同じではありません。
CRYPT_E_NOT_FOUND
 CRL が見つかりませんでした。 これは、ストアが空であるか、ストアのリストの末尾に達した場合に発生します。

解説

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

この関数によって返される CRL コンテキスト の複製は、 CertDuplicateCRLContext を呼び出すことによって行うことができます。

要件

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

関連項目

CRL_CONTEXT

CertDeleteCRLFromStore

CertDuplicateCRLContext

CertFindCRLInStore

CertFreeCRLContext

証明書失効リスト関数

GetLastError