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 和 ComputerName 追加到系统存储名称末尾的信息，请参阅 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
Library	Crypt32.lib
DLL	Crypt32.dll