Compartir a través de


Función CertEnumPhysicalStore (wincrypt.h)

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

Consulte también

CERT_SYSTEM_STORE_RELOCATE_PARA

CertEnumSystemStore

CertEnumSystemStoreLocation

CertRegisterPhysicalStore

CertRegisterSystemStore

CertUnregisterPhysicalStore

CertUnregisterSystemStore

Funciones del almacén de certificados