CertEnumCRLsInStore

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

CertEnumCRLsInStore hCertStore, pPrevCrlContext

hCertStore : [int] 証明書ストアのハンドル。
pPrevCrlContext : [var] 直前に見つかった CRL_CONTEXT 構造体へのポインター。ストアの最初の CRL を取得するには pPrevCrlContext を NULL にしなければならない。以降の CRL は、pPrevCrlContext に直前の呼び出しで返されたポインターを設定して列挙する。このパラメーターが NULL 以外の場合、本関数はそのポインターが参照する CRL_CONTEXT を解放する。列挙は CertDeleteCRLFromStore で既に削除された CRL をスキップする。

(プラグイン / モジュール : crypt32.dll)

解説

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

[戻り値]
関数が成功した場合、戻り値はストア内の次の CRL_CONTEXT へのポインター。関数が失敗した場合は NULL
が返される。拡張エラー情報は GetLastError を呼び出して取得する。想定されるエラーコードを以下に示す。
（以下省略）

[備考]
返されたポインターは、次回の呼び出しで pPrevCrlContext
として渡されると解放される。そうでない場合、CertFreeCRLContext
を呼び出してポインターを明示的に解放しなければならない。NULL 以外の pPrevCrlContext
は、関数自体がエラーを返した場合でも、本関数に渡されると常に CertFreeCRLContext の呼び出しで解放される。本関数が返す
CRL コンテキストの複製は CertDuplicateCRLContext を呼び出して作成できる。

情報