PFN_CERT_ENUM_PHYSICAL_STORE fonction de rappel (wincrypt.h)

Article
08/27/2023

La fonction de rappel CertEnumPhysicalStoreCallback met en forme et présente des informations sur chaque magasin physique trouvé par un appel à CertEnumPhysicalStore.

Syntaxe

PFN_CERT_ENUM_PHYSICAL_STORE PfnCertEnumPhysicalStore;

BOOL PfnCertEnumPhysicalStore(
  [in] const void *pvSystemStore,
  [in] DWORD dwFlags,
  [in] LPCWSTR pwszStoreName,
  [in] PCERT_PHYSICAL_STORE_INFO pStoreInfo,
  [in] void *pvReserved,
  [in] void *pvArg
)
{...}

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 du nom d’un service ou d’un ordinateur sur le 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 de mot élevé. La constante CERT_PHYSICAL_STORE_PREDEFINED_ENUM_FLAG est définie si le magasin physique est prédéfini plutôt qu’inscrit.

[in] pwszStoreName

Nom du magasin physique.

[in] pStoreInfo

Pointeur vers une structure CERT_PHYSICAL_STORE_INFO contenant des informations sur le magasin.

[in] pvReserved

Réservé pour un usage futur.

[in] pvArg

Pointeur vers les informations transmises à la fonction de rappel dans le pvArg transmis à CertEnumPhysicalStore.

Valeur retournée

Retourne TRUE si la fonction réussit, FALSE en cas d’échec.

Configuration requise


Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wincrypt.h