CertFindCRLInStore

dwFindType パラメーターと関連する pvFindPara パラメーターによって指定された検索条件に一致する証明書失効リスト (CRL) コンテキストのうち、最初または次のものを証明書ストアから見つける。

CertFindCRLInStore hCertStore, dwCertEncodingType, dwFindFlags, dwFindType, pvFindPara, pPrevCrlContext

hCertStore : [int] 検索対象の証明書ストアのハンドル。
dwCertEncodingType : [int] このパラメーターは現在使用されていない。0 に設定しなければならない。
dwFindFlags : [int] dwFindType が CRL_FIND_ISSUED_BY の場合、既定では発行者名の照合のみが行われる。次のフラグを使用して追加の絞り込みを行える。
dwFindType : [int] 行う検索の種別を指定する。dwFindType の値が、pvFindPara パラメーターのデータ型、内容、および使用方法を決定する。現在定義されている検索種別と pvFindPara の要件は次のとおり。
pvFindPara : [intptr] このパラメーターは dwFindType の値によって決まる。詳しくはこのトピック前出の表を参照。
pPrevCrlContext : [var] 本関数が直前に返した CRL_CONTEXT へのポインター。検索条件を満たすストア内の最初の CRL を取得するには NULL にしなければならない。以降の検索条件に一致する CRL は、pPrevCrlContext に直前の呼び出しで返された PCCRL_CONTEXT ポインターを設定することで取得できる。検索処理は、検索条件に一致しない CRL、または CertDeleteCRLFromStore で既に削除された CRL をスキップする。このパラメーターが NULL でない場合、本関数はそのポインターが参照する CRL_CONTEXT を解放する。

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

解説

dwFindType パラメーターと関連する pvFindPara パラメーターによって指定された検索条件に一致する証明書失効リスト
(CRL) コンテキストのうち、最初または次のものを証明書ストアから見つける。

[戻り値]
関数が成功した場合、関数は読み取り専用の CRL コンテキストへのポインターを返す。返された CRL
コンテキストの使用を終えたら、CertFreeCRLContext 関数を呼び出して解放するか、後続の
CertFindCRLInStore の呼び出しで pPrevCrlContext パラメーターとして渡して暗黙的に解放する。
関数が失敗し、検索条件に一致する CRL が見つからなかった場合、戻り値は NULL。拡張エラー情報は GetLastError
を呼び出して取得する。想定されるエラーコードを以下に示す。
（以下省略）

[備考]
返されたポインターは、次回の呼び出しで pPrevCrlContext
として渡されると解放される。そうでない場合、CertFreeCRLContext を呼び出して明示的に解放しなければならない。NULL
以外の pPrevCrlContext は、本関数内でエラーが発生した場合でも、CertFindCRLInStore が
CertFreeCRLContext の呼び出しにより常に解放する。
返されたコンテキストの複製は CertDuplicateCRLContext を呼び出して作成できる。返された CRL コンテキストは
CertAddCRLContextToStore を使用して別の証明書ストアに追加できる。また、CertAddCRLLinkToStore
を使用して、その CRL コンテキストへのリンクを非コレクションストアに追加することもできる。

情報