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
さらに、CERT_SYSTEM_STORE_RELOCATE_FLAGまたはCERT_PHYSICAL_STORE_PREDEFINED_ENUM_FLAGは、ビットごとの OR 演算を使用して、任意の高ワード位置フラグと組み合わせることができます。

[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

関連項目

CERT_SYSTEM_STORE_RELOCATE_PARA

CertEnumSystemStore

CertEnumSystemStoreLocation

CertRegisterPhysicalStore

CertRegisterSystemStore

CertUnregisterPhysicalStore

CertUnregisterSystemStore

証明書ストア関数