CertEnumCertificatesInStore

証明書ストア内の最初または次の証明書を取得する。ループで呼び出すことで全証明書を順に列挙できる。

CertEnumCertificatesInStore hCertStore, pPrevCertContext

hCertStore : [int] 証明書ストアのハンドル。
pPrevCertContext : [var] 前回見つかった証明書コンテキストの CERT_CONTEXT へのポインタ。列挙開始時は NULL を渡す。後続の呼び出しでは前回の戻り値を渡す。NULL でない値は本関数により解放される。論理ストア(コレクションストア含む)では、返された pCertContext の複製を使って新たな列挙サブシーケンスを開始することはできない。列挙は CertDeleteCertificateFromStore で以前削除された証明書をスキップする。

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

解説

証明書ストア内の最初または次の証明書を取得する。ループで呼び出すことで全証明書を順に列挙できる。

[戻り値]
成功時はストア内の次の CERT_CONTEXT へのポインタを返す。これ以上証明書がない場合は NULL を返す。拡張エラー情報は
GetLastError で取得する。主なエラーコードは以下の通り。
（以下省略）

[備考]
返されたポインタは、後続呼び出しで pPrevCertContext として渡されたとき解放される。そうでない場合は
CertFreeCertificateContext で明示的に解放する必要がある。NULL でない pPrevCertContext
を渡した場合はエラー時も必ず解放される。現在列挙中の証明書の複製は CertDuplicateCertificateContext
で作成できる。

情報