Función CertRegisterPhysicalStore (wincrypt.h)

Artículo
03/15/2023

La función CertRegisterPhysicalStore agrega un almacén físico a una colección de almacenes del sistema del Registro.

Sintaxis

BOOL CertRegisterPhysicalStore(
  [in] const void                *pvSystemStore,
  [in] DWORD                     dwFlags,
  [in] LPCWSTR                   pwszStoreName,
  [in] PCERT_PHYSICAL_STORE_INFO pStoreInfo,
  [in] void                      *pvReserved
);

Parámetros

[in] pvSystemStore

Colección del almacén del sistema a la que se agrega el almacén físico. Este parámetro apunta a una cadena Unicode terminada en null o a una estructura CERT_SYSTEM_STORE_RELOCATE_PARA . Para obtener información sobre el uso de la estructura y sobre cómo agregar un ServiceName o ComputerName antes de la cadena de nombre del almacén del sistema, vea CertRegisterSystemStore.

[in] dwFlags

La palabra alta del parámetro dwFlags especifica la ubicación del almacén del sistema. Para obtener información sobre las marcas de palabra alta definidas y anexar ServiceName, UserNames y ComputerNames al final del nombre del almacén del sistema, vea CertRegisterSystemStore.

También se definen las siguientes marcas de palabra baja y se pueden combinar con marcas de palabra alta mediante una operación OR bit a bit.

Valor	Significado
CERT_SYSTEM_STORE_RELOCATE_FLAG	El almacén del sistema no está en su ubicación predeterminada del Registro y el parámetro pvSystemStore debe ser un puntero a una estructura de CERT_SYSTEM_STORE_RELOCATE_PARA .
CERT_STORE_CREATE_NEW_FLAG	Se produce un error en la función si el almacén físico ya existe en la ubicación del almacén.

[in] pwszStoreName

Puntero a una cadena Unicode que asigna un nombre al almacén físico que se va a agregar a la colección de almacenes del sistema. Para quitar un almacén físico de la colección de almacenes del sistema, llame a la función CertUnregisterPhysicalStore .

[in] pStoreInfo

Puntero a una estructura de CERT_PHYSICAL_STORE_INFO que proporciona información básica sobre el almacén físico.

[in] pvReserved

Reservado para uso futuro y debe establecerse en NULL.

Valor devuelto

Si la función se ejecuta correctamente, la función devuelve un valor distinto de cero.

Si se produce un error en la función, devuelve cero.

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
Library	Crypt32.lib
Archivo DLL	Crypt32.dll