Fonction CertEnumSystemStore (wincrypt.h)

Article
08/27/2023

La fonction CertEnumSystemStore récupère les magasins système disponibles. La fonction appelle la fonction de rappel fournie pour chaque magasin système trouvé.

Syntaxe

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

Paramètres

[in] dwFlags

Spécifie l’emplacement du magasin système. Ce paramètre peut être l’un des indicateurs suivants :

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

En outre, les CERT_SYSTEM_STORE_RELOCATE_FLAG peuvent être combinées, à l’aide d’une opération OR au niveau du bit, avec n’importe quel indicateur d’emplacement de mot élevé.

[in, optional] pvSystemStoreLocationPara

Si CERT_SYSTEM_STORE_RELOCATE_FLAG est défini dans le paramètre dwFlags , pvSystemStoreLocationPara pointe vers une structure CERT_SYSTEM_STORE_RELOCATE_PARA qui indique à la fois le nom et l’emplacement du magasin système. Sinon, pvSystemStoreLocationPara est un pointeur vers une chaîne Unicode qui nomme le magasin système.

Pour CERT_SYSTEM_STORE_LOCAL_MACHINE ou CERT_SYSTEM_STORE_LOCAL_MACHINE_GROUP_POLICY, pvSystemStoreLocationPara peut éventuellement être défini sur un nom d’ordinateur Unicode pour l’énumération des magasins d’ordinateurs locaux sur un ordinateur distant, par exemple « \\computer_name » ou « computer_name ». Les barres obliques inverses de début (\) sont facultatives dans le computer_name.

Par CERT_SYSTEM_STORE_SERVICES ou CERT_SYSTEM_STORE_USERS, si pvSystemStoreLocationPara a la valeur NULL, la fonction énumère à la fois les noms de service/d’utilisateur et les magasins de chaque nom d’utilisateur/service. Sinon, pvSystemStoreLocationPara est une chaîne Unicode qui contient un nom d’ordinateur distant et, le cas échéant, un nom d’utilisateur/service, par exemple, « service_name », « \\computer_name » ou « computer_name ».

Si seule la computer_name est spécifiée, elle doit avoir les barres obliques inverses de début (\) ou une barre oblique inverse de fin (\). Sinon, il est interprété comme le service_name ou user_name.

[in] pvArg

Pointeur vers un void qui permet à l’application de déclarer, de définir et d’initialiser une structure pour contenir toutes les informations à transmettre à la fonction d’énumération de rappel.

[in] pfnEnum

Pointeur vers la fonction de rappel utilisée pour afficher les détails de chaque magasin système. Cette fonction de rappel détermine le contenu et le format de la présentation des informations sur chaque magasin système. L’application doit fournir la fonction de rappel CertEnumSystemStoreCallback .

Valeur retournée

Si la fonction réussit, la fonction retourne TRUE.

Si la fonction échoue, elle retourne FALSE.

Remarques

Pour utiliser CertEnumSystemStore, l’application doit déclarer et définir la structure ENUM_ARG et la fonction de rappel CertEnumSystemStoreCallback .

Exemples

Pour obtenir un exemple qui utilise cette fonction, consultez Exemple de programme C : Système de référencement et magasins physiques.

Configuration requise


Client minimal pris en charge	Windows XP [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	wincrypt.h
Bibliothèque	Crypt32.lib
DLL	Crypt32.dll