Función CertEnumPhysicalStore (wincrypt.h)

Artículo
03/15/2023

La función CertEnumPhysicalStore recupera los almacenes físicos de un equipo. La función llama a la función de devolución de llamada proporcionada para cada almacén físico encontrado.

Sintaxis

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

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 un ServiceName o ComputerName 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.

[in] pvArg

Puntero a un void que permite a la aplicación declarar, definir e inicializar una estructura para contener cualquier información que se pase a la función de enumeración de devolución de llamada.

[in] pfnEnum

Puntero a la función de devolución de llamada usada para mostrar los detalles de cada almacén físico. Esta función de devolución de llamada determina el contenido y el formato de la presentación de información en cada almacén físico. La aplicación debe proporcionar la función de devolución de llamada CertEnumPhysicalStoreCallback .

Valor devuelto

Si la función se ejecuta correctamente y se encontró otro almacén físico, el valor devuelto es TRUE.

Si la ubicación del almacén del sistema solo admite almacenes del sistema y no admite almacenes físicos, la función devuelve FALSE y GetLastError devuelve el código ERROR_NOT_SUPPORTED.

Si se produce un error en la función y no se encontró otro almacén físico, el valor devuelto es FALSE. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Para usar CertEnumPhysicalStore, una aplicación debe declarar y definir la estructura de ENUM_ARG y una función de devolución de llamada de enumeración.

Ejemplos

Vea Programa C de ejemplo: Enumerar el sistema y los almacenes físicos.

Requisitos


Cliente mínimo compatible	Windows XP [aplicaciones de escritorio \| aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2003 [aplicaciones de escritorio \| aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	wincrypt.h
Library	Crypt32.lib
Archivo DLL	Crypt32.dll