Función CryptCATOpen (mscat.h)

  • Artículo

[La función CryptCATOpen 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 CryptCATOpen abre un catálogo y devuelve un identificador de contexto al catálogo abierto.

Nota Algunas versiones anteriores de Wintrust.lib no contienen la información de exportación de esta función. En este caso, debe usar las funciones LoadLibrary y GetProcAddress para vincular dinámicamente a Wintrust.dll.
 

Sintaxis

HANDLE CryptCATOpen(
  [in] LPWSTR     pwszFileName,
  [in] DWORD      fdwOpenFlags,
  [in] HCRYPTPROV hProv,
  [in] DWORD      dwPublicVersion,
  [in] DWORD      dwEncodingType
);

Parámetros

[in] pwszFileName

Puntero a una cadena terminada en null para el nombre del archivo de catálogo.

[in] fdwOpenFlags

Cero, para abrir un archivo de catálogo existente o una combinación bit a bit de uno o varios de los valores siguientes.

Valor Significado
CRYPTCAT_OPEN_ALWAYS
 Abre el archivo, si existe o crea un nuevo archivo, si es necesario.
CRYPTCAT_OPEN_CREATENEW
 Se crea un nuevo archivo de catálogo. Si existe un archivo creado anteriormente, se sobrescribe.
CRYPTCAT_OPEN_EXISTING
 Se abre un archivo de catálogo existente.
CRYPTCAT_OPEN_EXCLUDE_PAGE_HASHES
 Se abre un archivo de catálogo existente. Excluya los hashes de página en SPC_INDIRECT_DATA.
CRYPTCAT_OPEN_INCLUDE_PAGE_HASHES
 Se abre un archivo de catálogo existente. Incluya hashes de página en SPC_INDIRECT_DATA. El CRYPTCAT_OPEN_EXCLUDE_PAGE_HASHES anterior tiene prioridad si también se establece.
CRYPTCAT_OPEN_VERIFYSIGHASH
 Se abre un archivo de catálogo existente. Comprueba la firma, no los certificados.
CRYPTCAT_OPEN_NO_CONTENT_HCRYPTMSG
 Se abre un archivo de catálogo existente. Realiza CryptMsgDecode sin contenido.
CRYPTCAT_OPEN_SORTED
 Se abre un archivo de catálogo existente. Realiza CertCreateContext(CERT_CREATE_CONTEXT_SORTED_FLAG).

[in] hProv

Identificador de un proveedor de servicios criptográficos (CSP).

[in] dwPublicVersion

Versión del archivo. Puede ser uno de los valores siguientes.

Valor Significado
CRYPTCAT_VERSION_1
0x100
 Formato de archivo de la versión 1.
CRYPTCAT_VERSION_2
0x200
 Formato de archivo de la versión 2.

Windows 8 y Windows Server 2012: Comienza la compatibilidad con este valor.

[in] dwEncodingType

Tipo de codificación usado para el archivo. Si este valor es 0, el tipo de codificación se establece en PKCS_7_ASN_ENCODING | X509_ASN_ENCODING.

Valor devuelto

Si se ejecuta correctamente, esta función devuelve un identificador al catálogo abierto. Cuando haya terminado de usar el identificador, ciérrelo llamando a la función CryptCATClose . La función CryptCATOpen devuelve INVALID_HANDLE_VALUE 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 mscat.h
Library Wintrust.lib
Archivo DLL Wintrust.dll

Consulte también

CryptCATClose