CertEnumPhysicalStore 函式 (wincrypt.h)

發行項
08/27/2023

CertEnumPhysicalStore函式會擷取電腦上的實體存放區。函式會針對找到的每個實體存放區呼叫提供的回呼函式。

語法

BOOL CertEnumPhysicalStore(
  [in] const void                   *pvSystemStore,
  [in] DWORD                        dwFlags,
  [in] void                         *pvArg,
  [in] PFN_CERT_ENUM_PHYSICAL_STORE pfnEnum
);

參數

[in] pvSystemStore

如果在 dwFlags中設定CERT_SYSTEM_STORE_RELOCATE_FLAG， pvSystemStore 會指向指出要列舉之系統存放區名稱和位置的 CERT_SYSTEM_STORE_RELOCATE_PARA 結構。否則， pvSystemStore 是 Unicode 字串的指標，此字串會命名要列舉其實體存放區的系統存放區。如需將 ServiceName 或 ComputerName 前置詞至系統存放區名稱的相關資訊，請參閱 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 運算來結合。

[in] pvArg

void的指標，可讓應用程式宣告、定義及初始化結構，以保存要傳遞至回呼列舉函數的任何資訊。

[in] pfnEnum

回呼函式的指標，用來顯示每個實體存放區的詳細資料。此回呼函式會決定每個實體存放區上資訊呈現的內容和格式。應用程式必須提供 CertEnumPhysicalStoreCallback 回呼函式。

傳回值

如果函式成功且找到另一個實體存放區，則傳回值為 TRUE。

如果系統存放區位置只支援系統存放區，而且不支援實體存放區，則函式會傳回 FALSE ，而 GetLastError 會傳回ERROR_NOT_SUPPORTED程式碼。

如果函式失敗，且找不到另一個實體存放區，則傳回值為 FALSE。如需擴充錯誤資訊，請呼叫 GetLastError。

備註

若要使用 CertEnumPhysicalStore，應用程式必須宣告並定義 ENUM_ARG 結構和列舉回呼函式。

範例

請參閱範例 C 程式：列出系統和實體存放區。

規格需求


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