Compartir a través de

Función CryptCATPersistStore (mscat.h)

  • Artículo

[La función CryptCATPersistStore está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores.

La función CryptCATPersistStore guarda la información del almacén de catálogos especificado en un archivo de catálogo sin firmar.

Sintaxis

BOOL CryptCATPersistStore(
  [in] HANDLE hCatalog
);

Parámetros

[in] hCatalog

Identificador del catálogo obtenido de la función CryptCATHandleFromStore o CryptCATOpen . A partir de Windows 8, solo debes usar CryptCATOpen para recuperar un identificador.

Valor devuelto

El valor devuelto es TRUE si la función se realiza correctamente; de lo contrario, FALSE.

Si esta función devuelve FALSE, se puede obtener información de error adicional llamando a la función GetLastError . GetLastError devolverá el siguiente código de error.

Código devuelto Descripción
ERROR_INVALID_PARAMETER
 Uno o varios de los parámetros no son válidos.
ERROR_NOT_SUPPORTED
 A partir de Windows 8 y Windows Server 2012, debe recuperar un identificador llamando a la función CryptCATOpen con el parámetro dwPublicVersion establecido en 0x100 o 0x200. Para obtener más información, vea la sección Comentarios.

Comentarios

La estructura CRYPTCATSTORE debe inicializarse antes de llamar a CryptCATPersistStore.

A partir de Windows 8 y Windows Server 2012, los siguientes cambios se aplican a esta función:

  • Si se llamó a CryptCATOpen con un parámetro dwPublicVersion de 0x200, el catálogo se escribe con el formato v2.
  • Si se llamó a CryptCATOpen con un parámetro dwPublicVersion de 0x100, el catálogo se escribe con el formato v1.
  • Si se llamó a CryptCATOpen con un parámetro dwPublicVersion distinto de 0x200 o 0x100, la función CryptCATPersistStore devuelve FALSE y el código de error se establece en ERROR_NOT_SUPPORTED.

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 mscat.h
Library Wintrust.lib
Archivo DLL Wintrust.dll