PFN_CERT_ENUM_PHYSICAL_STORE función de devolución de llamada (wincrypt.h)

Artículo
08/27/2023

La función de devolución de llamada CertEnumPhysicalStoreCallback da formato y presenta información sobre cada almacén físico encontrado por una llamada a CertEnumPhysicalStore.

Sintaxis

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

Parámetros

[in] pvSystemStore

Si CERT_SYSTEM_STORE_RELOCATE_FLAG se establece en dwFlags, pvSystemStore apunta a una estructura de CERT_SYSTEM_STORE_RELOCATE_PARA que indica el nombre y la ubicación del almacén del sistema que se va a enumerar. De lo contrario, pvSystemStore es un puntero a una cadena Unicode que asigna un nombre al almacén del sistema cuyos almacenes físicos se van a enumerar. Para obtener información sobre cómo prefijar el nombre de un servicio o equipo al nombre del almacén del sistema, vea CertRegisterSystemStore.

[in] dwFlags

Especifica la ubicación del almacén del sistema. Se definen los siguientes valores de marca:

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

Además, CERT_SYSTEM_STORE_RELOCATE_FLAG o CERT_PHYSICAL_STORE_PREDEFINED_ENUM_FLAG se pueden combinar mediante una operación OR bit a bit con cualquiera de las marcas de ubicación de palabra alta. La constante CERT_PHYSICAL_STORE_PREDEFINED_ENUM_FLAG se establece si el almacén físico está predefinido en lugar de registrado.

[in] pwszStoreName

Nombre del almacén físico.

[in] pStoreInfo

Puntero a una estructura de CERT_PHYSICAL_STORE_INFO que contiene información sobre el almacén.

[in] pvReserved

Reservado para uso futuro.

[in] pvArg

Puntero a la información que se pasa a la función de devolución de llamada en el pvArg pasado a CertEnumPhysicalStore.

Valor devuelto

Devuelve TRUE si la función se realiza correctamente, FALSE si se produce un error.

Requisitos


Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wincrypt.h