PFN_CERT_ENUM_PHYSICAL_STORE回调函数 (wincrypt.h)

项目
08/27/2023

CertEnumPhysicalStoreCallback 回调函数格式化并提供有关调用 CertEnumPhysicalStore 找到的每个物理存储的信息。

语法

PFN_CERT_ENUM_PHYSICAL_STORE PfnCertEnumPhysicalStore;

BOOL PfnCertEnumPhysicalStore(
  [in] const void *pvSystemStore,
  [in] DWORD dwFlags,
  [in] LPCWSTR pwszStoreName,
  [in] PCERT_PHYSICAL_STORE_INFO pStoreInfo,
  [in] void *pvReserved,
  [in] void *pvArg
)
{...}

参数

[in] pvSystemStore

如果在 dwFlags 中设置了CERT_SYSTEM_STORE_RELOCATE_FLAG， 则 pvSystemStore 指向 CERT_SYSTEM_STORE_RELOCATE_PARA 结构，该结构指示要枚举的系统存储的名称和位置。否则， pvSystemStore 是指向 Unicode 字符串的指针，该字符串将命名要枚举其物理存储的系统存储。有关将服务或计算机名称作为系统存储名称前缀的信息，请参阅 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

此外，可以使用按位 OR 运算将CERT_SYSTEM_STORE_RELOCATE_FLAG或CERT_PHYSICAL_STORE_PREDEFINED_ENUM_FLAG与任何高字位置标志组合在一起。如果预定义而不是注册物理存储，则会设置CERT_PHYSICAL_STORE_PREDEFINED_ENUM_FLAG常量。

[in] pwszStoreName

物理存储的名称。

[in] pStoreInfo

指向包含存储相关信息的 CERT_PHYSICAL_STORE_INFO 结构的指针。

[in] pvReserved

保留供将来使用。

[in] pvArg

指向传递到 CertEnumPhysicalStore 的 pvArg 中回调函数的信息的指针。

返回值

如果函数成功，则返回 TRUE ;如果失败，则返回 FALSE 。

要求


最低受支持的客户端	Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	wincrypt.h