CertEnumPhysicalStore 関数 (wincrypt.h)
CertEnumPhysicalStore 関数は、コンピューター上の物理ストアを取得します。 関数は、検出された各物理ストアに対して提供されたコールバック関数を呼び出します。
構文
BOOL CertEnumPhysicalStore(
[in] const void *pvSystemStore,
[in] DWORD dwFlags,
[in] void *pvArg,
[in] PFN_CERT_ENUM_PHYSICAL_STORE pfnEnum
);
パラメーター
[in] pvSystemStore
CERT_SYSTEM_STORE_RELOCATE_FLAGが dwFlags に設定されている場合、pvSystemStore は、列挙するシステム ストアの名前と場所の両方を示すCERT_SYSTEM_STORE_RELOCATE_PARA構造体を指します。 それ以外の場合、 pvSystemStore は、物理ストアを列挙するシステム ストアに名前を付ける Unicode 文字列へのポインターです。 システム ストア名に ServiceName または ComputerName のプレフィックスを付ける方法については、「 CertRegisterSystemStore」を参照してください。
[in] dwFlags
システム ストアの場所を指定します。 次のフラグ値が定義されています。
- CERT_SYSTEM_STORE_CURRENT_USER
- CERT_SYSTEM_STORE_CURRENT_SERVICE
- CERT_SYSTEM_STORE_LOCAL_MACHINE
- CERT_SYSTEM_STORE_LOCAL_MACHINE_GROUP_POLICY
- CERT_SYSTEM_STORE_CURRENT_USER_GROUP_POLICY
- CERT_SYSTEM_STORE_SERVICES
- CERT_SYSTEM_STORE_USERS
- CERT_SYSTEM_STORE_LOCAL_MACHINE_ENTERPRISE
[in] pvArg
コールバック列挙関数に渡される情報を保持する構造体をアプリケーションが宣言、定義、初期化できるようにする void へのポインター。
[in] pfnEnum
各物理ストアの詳細を表示するために使用されるコールバック関数へのポインター。 このコールバック関数は、各物理ストアに関する情報の表示の内容と形式を決定します。 アプリケーションは 、CertEnumPhysicalStoreCallback コールバック関数を提供する必要があります。
戻り値
関数が成功し、別の物理ストアが見つかった場合、戻り値は TRUE です。
システム ストアの場所がシステム ストアのみをサポートし、物理ストアをサポートしていない場合、関数は FALSE を 返し、 GetLastError は ERROR_NOT_SUPPORTED コードを返します。
関数が失敗し、別の物理ストアが見つからなかった場合、戻り値は FALSE になります。 拡張エラー情報については、 GetLastError を呼び出します。
解説
CertEnumPhysicalStore を使用するには、アプリケーションでENUM_ARG構造体と列挙コールバック関数を宣言して定義する必要があります。
例
「サンプル C プログラム: システムストアと物理ストアを一覧表示する」を参照してください。
要件
| サポートされている最小のクライアント | Windows XP [デスクトップ アプリ | UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2003 [デスクトップ アプリのみ | UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | wincrypt.h |
| Library | Crypt32.lib |
| [DLL] | Crypt32.dll |