共用方式為


CertEnumSystemStore 函式 (wincrypt.h)

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,如果 pvSystemStoreLocationParaNull,函式會列舉每個服務/使用者名稱的服務/使用者名稱和存放區。 否則, pvSystemStoreLocationPara 是包含遠端電腦名稱稱的 Unicode 字串,如果有的話,服務/使用者名稱,例如 「service_name」、「\\computer_name」 或 「computer_name」。

如果只指定 computer_name ,它必須具有前置反斜線 (\) 或尾端反斜線 (\) 。 否則,它會解譯為 service_nameuser_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

另請參閱

CERT_SYSTEM_STORE_RELOCATE_PARA

CertEnumPhysicalStore

CertEnumSystemStoreLocation

CertRegisterPhysicalStore

CertRegisterSystemStore

CertUnregisterPhysicalStore

CertUnregisterSystemStore

憑證存放區函式