CertRegisterPhysicalStore 関数 (wincrypt.h)

CertRegisterPhysicalStore 関数は、レジストリ システム ストア コレクションに物理ストアを追加します。

構文

BOOL CertRegisterPhysicalStore(
  [in] const void                *pvSystemStore,
  [in] DWORD                     dwFlags,
  [in] LPCWSTR                   pwszStoreName,
  [in] PCERT_PHYSICAL_STORE_INFO pStoreInfo,
  [in] void                      *pvReserved
);

パラメーター

[in] pvSystemStore

物理ストアが追加されるシステム ストア コレクション。 このパラメーターは、 null で終わる Unicode 文字列または CERT_SYSTEM_STORE_RELOCATE_PARA 構造体を指します。 構造体の使用と、システム ストア名文字列の前に ServiceName または ComputerName を追加する方法については、「 CertRegisterSystemStore」を参照してください。

[in] dwFlags

dwFlags パラメーターの上位ワードは、システム ストアの場所を指定します。 定義された高ワード フラグと、ServiceName、UserNames、ComputerNames をシステム ストア名の末尾に追加する方法については、「 CertRegisterSystemStore」を参照してください。

次のローワード フラグも定義されており、ビットごとの OR 演算を使用してハイワード フラグと組み合わせることができます。

説明
CERT_SYSTEM_STORE_RELOCATE_FLAG
システム ストアは既定のレジストリの場所に存在せず、 pvSystemStore パラメーターは CERT_SYSTEM_STORE_RELOCATE_PARA 構造体へのポインターである必要があります。
CERT_STORE_CREATE_NEW_FLAG
物理ストアがストアの場所に既に存在する場合、関数は失敗します。

[in] pwszStoreName

システム ストア コレクションに追加する物理ストアに名前を付ける Unicode 文字列へのポインター。 システム ストア コレクションから物理ストアを削除するには、 CertUnregisterPhysicalStore 関数を呼び出します。

[in] pStoreInfo

物理ストアに関する基本情報を提供する CERT_PHYSICAL_STORE_INFO 構造体へのポインター。

[in] pvReserved

将来使用するために予約されており、 NULL に設定する必要があります。

戻り値

関数が成功した場合、関数は 0 以外の値を返します。

関数が失敗すると、0 が返されます。

要件

   
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー wincrypt.h
Library Crypt32.lib
[DLL] Crypt32.dll

関連項目

CERT_PHYSICAL_STORE_INFO

CertEnumPhysicalStore

CertEnumSystemStore

CertEnumSystemStoreLocation

CertRegisterSystemStore

CertUnregisterPhysicalStore

証明書ストア関数