CertFindChainInStore

ストア内で指定した条件を満たす最初または次の証明書を見つける。

CertFindChainInStore hCertStore, dwCertEncodingType, dwFindFlags, dwFindType, pvFindPara, pPrevChainContext

hCertStore : [int] チェーンを構築する証明書を検索する対象のストアのハンドル。このハンドルは、チェーン構築時に追加のストアとして CertGetCertificateChain 関数に渡される。
dwCertEncodingType : [int] ストアのエンコードに使用された証明書エンコード種別。この値の上位 WORD に含まれるメッセージエンコード種別識別子は、本関数では無視される。
dwFindFlags : [int] 検索の追加オプションを含む。このパラメーターの指定可能な値は dwFindType パラメーターの値に依存する。
dwFindType : [int] ストア内の証明書を見つけるために使用する条件を決定する。
pvFindPara : [intptr] 追加の検索条件を含むポインター。このパラメーターが指すデータの型と形式は dwFindType パラメーターの値に依存する。
pPrevChainContext : [var] 本関数の直前の呼び出しから返された CERT_CHAIN_CONTEXT 構造体へのポインター。検索はこの証明書から開始される。本関数への最初の呼び出しではこのパラメーターは NULL でなければならない。以降の呼び出しでは、直前の呼び出しで返されたポインターを指定する。このパラメーターが NULL でない場合、本関数はこの構造体を解放する。

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

解説

ストア内で指定した条件を満たす最初または次の証明書を見つける。

[戻り値]
最初または次のチェーンコンテキストが構築されなかった場合は NULL を返す。そうでない場合、読み取り専用の
CERT_CHAIN_CONTEXT 構造体へのポインターを返す。CERT_CHAIN_CONTEXT 構造体は、後続の本関数呼び出しで
pPrevChainContext
パラメーターとして渡されると解放される。そうでない場合、CertFreeCertificateChain
関数を呼び出して明示的に解放しなければならない。

[備考]
チェーンコンテキストを構築する最初の呼び出しでは pPrevChainContext パラメーターは NULL
でなければならない。次のチェーンコンテキストを構築するには、pPrevChainContext に直前の呼び出しで返された
CERT_CHAIN_CONTEXT 構造体を設定する。pPrevChainContext が NULL
でない場合、エラーが発生した場合でも、本関数は常に CertFreeCertificateChain 関数を使用してその構造体を解放する。

情報