Funzione CertEnumSystemStore (wincrypt.h)

Articolo
08/27/2023

La funzione CertEnumSystemStore recupera gli archivi di sistema disponibili. La funzione chiama la funzione di callback fornita per ogni archivio di sistema trovato.

Sintassi

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

Parametri

[in] dwFlags

Specifica il percorso dell'archivio di sistema. Questo parametro può essere uno dei flag seguenti:

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, il CERT_SYSTEM_STORE_RELOCATE_FLAG può essere combinato, usando un'operazione OR bit per bit, con uno qualsiasi dei flag di posizione con parole elevate.

[in, optional] pvSystemStoreLocationPara

Se CERT_SYSTEM_STORE_RELOCATE_FLAG è impostato nel parametro dwFlags , pvSystemStoreLocationPara punta a una struttura CERT_SYSTEM_STORE_RELOCATE_PARA che indica sia il nome che la posizione dell'archivio di sistema. In caso contrario , pvSystemStoreLocationPara è un puntatore a una stringa Unicode che assegna un nome all'archivio di sistema.

Per CERT_SYSTEM_STORE_LOCAL_MACHINE o CERT_SYSTEM_STORE_LOCAL_MACHINE_GROUP_POLICY, pvSystemStoreLocationPara può essere impostato facoltativamente su un nome computer Unicode per enumerare gli archivi computer locali in un computer remoto, ad esempio "\\computer_name" o "computer_name". Le barre rovesciata iniziali (\) sono facoltative nella computer_name.

Per CERT_SYSTEM_STORE_SERVICES o CERT_SYSTEM_STORE_USERS, se pvSystemStoreLocationPara è NULL, la funzione enumera sia i nomi di servizio/utente che gli archivi per ogni nome servizio/utente. In caso contrario , pvSystemStoreLocationPara è una stringa Unicode che contiene un nome computer remoto e, se disponibile, un nome di servizio/utente, ad esempio "service_name", "\\computer_name" o "computer_name".

Se viene specificato solo il computer_name , deve avere le barre rovesciata iniziali (\) o una barra rovesciata finale (\). In caso contrario, viene interpretato come service_name o user_name.

[in] pvArg

Puntatore a un void che consente all'applicazione di dichiarare, definire e inizializzare una struttura in modo che contenga 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 di sistema. Questa funzione di callback determina il contenuto e il formato per la presentazione delle informazioni in ogni archivio di sistema. L'applicazione deve fornire la funzione di callback CertEnumSystemStoreCallback .

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce TRUE.

Se la funzione ha esito negativo, restituisce FALSE.

Commenti

Per usare CertEnumSystemStore, l'applicazione deve dichiarare e definire la struttura ENUM_ARG e la funzione di callback CertEnumSystemStoreCallback .

Esempio

Per un esempio che usa questa funzione, vedere Esempio di programma C: Elenco 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