CertRegisterPhysicalStore 函式 (wincrypt.h)

發行項
08/27/2023

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。

傳回值

如果函式成功，函式會傳回非零。

如果函式失敗，它會傳回零。

規格需求


最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	wincrypt.h
程式庫	Crypt32.lib
Dll	Crypt32.dll