CertFindCTLInStore

dwFindType とそれに関連付けられた pvFindPara によって指定された検索条件に一致する証明書信頼リスト (CTL) コンテキストのうち、最初または次のものを見つける。

CertFindCTLInStore hCertStore, dwMsgAndCertEncodingType, dwFindFlags, dwFindType, pvFindPara, pPrevCtlContext

hCertStore : [int] 検索対象の証明書ストアのハンドル。
dwMsgAndCertEncodingType : [int] CTL に使用されているエンコード種別を指定する。証明書エンコード種別とメッセージエンコード種別を、次の例のようにビットごとの OR 演算で組み合わせて指定することも常に可能である: X509_ASN_ENCODING | PKCS_7_ASN_ENCODING。現在定義されているエンコード種別は次のとおり。
dwFindFlags : [int] dwFindType が CTL_FIND_USAGE に設定されているときに指定できる。詳しくは後述の CTL_FIND_USAGE の説明を参照。
dwFindType : [int] 
pvFindPara : [intptr] dwFindType パラメーターに関連付けられた検索値へのポインター。
pPrevCtlContext : [var] 本関数が直前に返した CTL_CONTEXT へのポインター。ストア内の最初の CTL を取得するには NULL でなければならない。以降の CTL は、pPrevCtlContext に直前の呼び出しで返された CTL_CONTEXT へのポインターを設定することで取得する。検索条件に一致しない証明書や、CertDeleteCTLFromStore で既に削除された証明書はスキップされる。このパラメーターが NULL 以外の場合、本関数はそのポインターが参照する CTL_CONTEXT を解放する。

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

解説

dwFindType とそれに関連付けられた pvFindPara によって指定された検索条件に一致する証明書信頼リスト (CTL)
コンテキストのうち、最初または次のものを見つける。

[戻り値]
関数が成功した場合、戻り値は読み取り専用の CTL コンテキストへのポインター。拡張エラー情報は GetLastError
を呼び出して取得する。想定されるエラーコードを以下に示す。
（以下省略）

[備考]
返されたポインターは、次回の呼び出しで pPrevCtlContext として渡されると解放される。そうでない場合は
CertFreeCTLContext を呼び出して解放しなければならない。NULL 以外の pPrevCtlContext
は、本関数がエラーを発生させた場合でも、CertFreeCTLContext の呼び出しにより常に解放される。
返されたコンテキストの複製は CertDuplicateCTLContext を呼び出して作成できる。返された CTL コンテキストは
CertAddCTLContextToStore を使用して別の証明書ストアに追加できる。また、CertAddCTLLinkToStore
を使用して、その CTL コンテキストへのリンクを非コレクションストアに追加することもできる。検索条件に一致する CTL
が見つからない場合、NULL が返される。

情報