CertEnumCTLsInStore

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

CertEnumCTLsInStore hCertStore, pPrevCtlContext

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

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

解説

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

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

[備考]
返されたポインターは、次回の呼び出しで pPrevCtlContext
として渡されると解放される。そうでない場合、CertFreeCTLContext を呼び出して明示的に解放しなければならない。NULL
以外の pPrevCtlContext は、エラーの場合でも（CertFreeCTLContext
の呼び出しを通じて）本関数が常に解放する。複製は CertDuplicateCTLContext を呼び出して作成できる。

情報