Funzione CertEnumPhysicalStore (wincrypt.h)

Articolo
08/27/2023

La funzione CertEnumPhysicalStore recupera gli archivi fisici in un computer. La funzione chiama la funzione di callback fornita per ogni archivio fisico trovato.

Sintassi

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

Parametri

[in] pvSystemStore

Se CERT_SYSTEM_STORE_RELOCATE_FLAG è impostato in dwFlags, pvSystemStore punta a una struttura CERT_SYSTEM_STORE_RELOCATE_PARA che indica sia il nome che la posizione dell'archivio di sistema da enumerare. In caso contrario, pvSystemStore è un puntatore a una stringa Unicode che chiama l'archivio di sistema i cui archivi fisici devono essere enumerati. Per informazioni sul prefisso di un nome ServiceName o ComputerName sul nome dell'archivio di sistema, vedere CertRegisterSystemStore.

[in] dwFlags

Specifica il percorso dell'archivio di sistema. I valori di flag seguenti sono definiti:

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

Inoltre, CERT_SYSTEM_STORE_RELOCATE_FLAG o CERT_PHYSICAL_STORE_PREDEFINED_ENUM_FLAG possono essere combinati usando un'operazione BIT-OR con uno qualsiasi dei flag di posizione ad alta parola.

[in] pvArg

Puntatore a un void che consente all'applicazione di dichiarare, definire e inizializzare una struttura per contenere tutte le informazioni da passare alla funzione di enumerazione callback.

[in] pfnEnum

Puntatore alla funzione di callback usata per visualizzare i dettagli per ogni archivio fisico. Questa funzione di callback determina il contenuto e il formato per la presentazione di informazioni in ogni archivio fisico. L'applicazione deve fornire la funzione di callback CertEnumPhysicalStoreCallback .

Valore restituito

Se la funzione ha esito positivo e è stato trovato un altro archivio fisico, il valore restituito è TRUE.

Se il percorso dell'archivio di sistema supporta solo archivi di sistema e non supporta archivi fisici, la funzione restituisce FALSE e GetLastError restituisce il codice ERROR_NOT_SUPPORTED.

Se la funzione ha esito negativo e non è stato trovato un altro archivio fisico, il valore restituito è FALSE. Per informazioni sull'errore estese, chiamare GetLastError.

Commenti

Per usare CertEnumPhysicalStore, un'applicazione deve dichiarare e definire la struttura ENUM_ARG e una funzione di callback di enumerazione.

Esempio

Vedere Programma C di esempio: presentazione di archivi fisici e di sistema.

Requisiti


Client minimo supportato	Windows XP [app desktop \| App UWP]
Server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	wincrypt.h
Libreria	Crypt32.lib
DLL	Crypt32.dll