CertEnumPhysicalStore

CertEnumPhysicalStore 関数は、コンピューター上の物理ストアを取得する。見つかった各物理ストアについて、指定したコールバック関数を呼び出す。

CertEnumPhysicalStore pvSystemStore, dwFlags, pvArg, pfnEnum

pvSystemStore : [intptr] dwFlags に CERT_SYSTEM_STORE_RELOCATE_FLAG が設定されている場合、pvSystemStore は、列挙対象のシステムストアの名前と場所の両方を示す CERT_SYSTEM_STORE_RELOCATE_PARA 構造体を指す。そうでない場合、pvSystemStore は物理ストアを列挙する対象のシステムストア名を保持する Unicode 文字列へのポインター。ServiceName または ComputerName をシステムストア名の前に付加する方法については CertRegisterSystemStore を参照。
dwFlags : [int] システムストアの場所を指定する。次のフラグ値が定義されている。
pvArg : [intptr] コールバック列挙関数に渡す情報を格納する構造体を、アプリケーションが宣言・定義・初期化するための void へのポインター。
pfnEnum : [int] 各物理ストアの詳細を表示するために使用するコールバック関数へのポインター。このコールバック関数は、各物理ストアに関する情報の表示内容とフォーマットを決定する。アプリケーションは CertEnumPhysicalStoreCallback コールバック関数を提供しなければならない。

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

解説

CertEnumPhysicalStore
関数は、コンピューター上の物理ストアを取得する。見つかった各物理ストアについて、指定したコールバック関数を呼び出す。

[戻り値]
関数が成功し、別の物理ストアが見つかった場合、戻り値は
TRUE。システムストアの場所がシステムストアのみをサポートし、物理ストアをサポートしていない場合、関数は FALSE
を返し、GetLastError は ERROR_NOT_SUPPORTED
を返す。関数が失敗し、別の物理ストアが見つからなかった場合、戻り値は FALSE。拡張エラー情報は GetLastError
を呼び出して取得する。

[備考]
CertEnumPhysicalStore を使用するには、アプリケーションは ENUM_ARG
構造体と列挙コールバック関数を宣言・定義しなければならない。

情報