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 を呼び出します。 考えられるエラー コードの一部を次に示します。
| リターン コード | 説明 |
|---|---|
|
hCertStore パラメーターのハンドルは、pPrevCrlContext が指す証明書コンテキストのハンドルと同じではありません。 |
|
CRL が見つかりませんでした。 これは、ストアが空であるか、ストアのリストの末尾に達した場合に発生します。 |
解説
返されたポインターは、関数の後続の呼び出しで pPrevCrlContext として渡されると解放されます。 それ以外の場合は、 CertFreeCRLContext を呼び出して、ポインターを明示的に解放する必要があります。 NULL ではない pPrevCrlContext は、関数自体がエラーを返した場合でも、CertFreeCRLContext の呼び出しによってこの関数に渡されると常に解放されます。
この関数によって返される CRL コンテキスト の複製は、 CertDuplicateCRLContext を呼び出すことによって行うことができます。
要件
| サポートされている最小のクライアント | Windows XP [デスクトップ アプリ | UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2003 [デスクトップ アプリのみ | UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | wincrypt.h |
| Library | Crypt32.lib |
| [DLL] | Crypt32.dll |