CertEnumSystemStore 函式 (wincrypt.h)

發行項
08/27/2023

CertEnumSystemStore函式會擷取可用的系統存放區。函式會針對找到的每個系統存放區呼叫提供的回呼函式。

語法

BOOL CertEnumSystemStore(
  [in]           DWORD                      dwFlags,
  [in, optional] void                       *pvSystemStoreLocationPara,
  [in]           void                       *pvArg,
  [in]           PFN_CERT_ENUM_SYSTEM_STORE pfnEnum
);

參數

[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可以搭配任何高字位置旗標使用位OR 運算來結合。

[in, optional] pvSystemStoreLocationPara

如果在 dwFlags 參數中設定CERT_SYSTEM_STORE_RELOCATE_FLAG， pvSystemStoreLocationPara 會 指向指出系統存放區名稱和位置的CERT_SYSTEM_STORE_RELOCATE_PARA 結構。否則， pvSystemStoreLocationPara 是命名系統存放區的 Unicode 字串指標。

針對CERT_SYSTEM_STORE_LOCAL_MACHINE或CERT_SYSTEM_STORE_LOCAL_MACHINE_GROUP_POLICY， pvSystemStoreLocationPara 可以選擇性地設定為 Unicode 電腦名稱稱，以列舉遠端電腦上的本機電腦存放區，例如「\\computer_name」或「computer_name」。前置反斜線 (\) 在 computer_name中是選擇性的。

針對CERT_SYSTEM_STORE_SERVICES或CERT_SYSTEM_STORE_USERS，如果 pvSystemStoreLocationPara 為 Null，函式會列舉每個服務/使用者名稱的服務/使用者名稱和存放區。否則， pvSystemStoreLocationPara 是包含遠端電腦名稱稱的 Unicode 字串，如果有的話，服務/使用者名稱，例如「service_name」、「\\computer_name」或「computer_name」。

如果只指定 computer_name ，它必須具有前置反斜線 (\) 或尾端反斜線 (\) 。否則，它會解譯為 service_name 或 user_name。

[in] pvArg

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

[in] pfnEnum

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

傳回值

如果函式成功，函式會傳回 TRUE。

如果函式失敗，則會傳回 FALSE。

備註

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

範例

如需使用此函式的範例，請參閱範例 C 程式：列出系統和實體存放區。

規格需求


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