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

此外，CERT_SYSTEM_STORE_RELOCATE_FLAG或CERT_PHYSICAL_STORE_PREDEFINED_ENUM_FLAG可以搭配任何高字位置旗標使用位OR 運算來結合。如果預先定義實體存放區而非已註冊，則會設定CERT_PHYSICAL_STORE_PREDEFINED_ENUM_FLAG常數。

[in] pwszStoreName

實體存放區的名稱。

[in] pStoreInfo

包含存放區相關資訊之CERT_PHYSICAL_STORE_INFO 結構的指標。

[in] pvReserved

保留供未來使用。

[in] pvArg

傳遞給 pvArg 中傳遞至 CertEnumPhysicalStore之回呼函式之資訊的指標。

傳回值

如果函式成功，則會傳回 TRUE ;如果函式失敗則傳回 FALSE 。

規格需求


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