PFN_CERT_ENUM_PHYSICAL_STORE funzione di callback (wincrypt.h)

Articolo
03/15/2023

La funzione callback CertEnumPhysicalStoreCallback presenta informazioni su ogni archivio fisico trovato da una chiamata a CertEnumPhysicalStore.

Sintassi

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
)
{...}

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 del nome di un servizio o di un computer al 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. La costante CERT_PHYSICAL_STORE_PREDEFINED_ENUM_FLAG viene impostata se l'archivio fisico è predefinito anziché registrato.

[in] pwszStoreName

Nome dell'archivio fisico.

[in] pStoreInfo

Puntatore a una struttura CERT_PHYSICAL_STORE_INFO contenente informazioni sull'archivio.

[in] pvReserved

Riservato per utilizzi futuri.

[in] pvArg

Puntatore alle informazioni passate alla funzione di callback nel pvArg passato a CertEnumPhysicalStore.

Valore restituito

Restituisce TRUE se la funzione ha esito positivo, FALSE se ha esito negativo.

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wincrypt.h