Fonction CertEnumPhysicalStore (wincrypt.h)

Article
08/27/2023

La fonction CertEnumPhysicalStore récupère les magasins physiques sur un ordinateur. La fonction appelle la fonction de rappel fournie pour chaque magasin physique trouvé.

Syntaxe

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

Paramètres

[in] pvSystemStore

Si CERT_SYSTEM_STORE_RELOCATE_FLAG est défini dans dwFlags, pvSystemStore pointe vers une structure CERT_SYSTEM_STORE_RELOCATE_PARA qui indique à la fois le nom et l’emplacement du magasin système à énumérer. Sinon, pvSystemStore est un pointeur vers une chaîne Unicode qui nomme le magasin système dont les magasins physiques doivent être énumérés. Pour plus d’informations sur le préfixe d’un ServiceName ou d’un ComputerName au nom du magasin système, consultez CertRegisterSystemStore.

[in] dwFlags

Spécifie l’emplacement du magasin système. Les valeurs d’indicateur suivantes sont définies :

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, CERT_SYSTEM_STORE_RELOCATE_FLAG ou CERT_PHYSICAL_STORE_PREDEFINED_ENUM_FLAG peuvent être combinés à l’aide d’une opération OR au niveau du bit avec n’importe quel indicateur d’emplacement à mot élevé.

[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 à passer à 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 physique. Cette fonction de rappel détermine le contenu et le format pour la présentation des informations sur chaque magasin physique. L’application doit fournir la fonction de rappel CertEnumPhysicalStoreCallback .

Valeur retournée

Si la fonction réussit et qu’un autre magasin physique a été trouvé, la valeur de retour est TRUE.

Si l’emplacement du magasin système prend uniquement en charge les magasins système et ne prend pas en charge les magasins physiques, la fonction retourne FALSE et GetLastError renvoie le code ERROR_NOT_SUPPORTED.

Si la fonction échoue et qu’un autre magasin physique est introuvable, la valeur de retour est FALSE. Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Remarques

Pour utiliser CertEnumPhysicalStore, une application doit déclarer et définir la structure ENUM_ARG et une fonction de rappel d’énumération.

Exemples

Consultez l’exemple de programme C : référencement des magasins système et 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