Función CertCreateCTLContext (wincrypt.h)

Artículo
03/13/2024

La función CertCreateCTLContext crea un contexto de lista de confianza de certificados (CTL) a partir de un CTL codificado. El contexto creado no se conserva en un almacén de certificados. La función realiza una copia del CTL codificado en el contexto creado.

Sintaxis

PCCTL_CONTEXT CertCreateCTLContext(
  [in] DWORD      dwMsgAndCertEncodingType,
  [in] const BYTE *pbCtlEncoded,
  [in] DWORD      cbCtlEncoded
);

Parámetros

[in] dwMsgAndCertEncodingType

Especifica el tipo de codificación utilizada. Los tipos de codificación de certificados y mensajes deben especificarse combinándolos con una operación OR bit a bit, como se muestra en el ejemplo siguiente:

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING tipos de codificación definidos actualmente son:

X509_ASN_ENCODING
PKCS_7_ASN_ENCODING

[in] pbCtlEncoded

Puntero a un búfer que contiene el CTL codificado desde el que se va a crear el contexto.

[in] cbCtlEncoded

Tamaño, en bytes, del búfer pbCtlEncoded .

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un puntero a un CTL_CONTEXT de solo lectura.

Si se produce un error en la función y no puede descodificar y crear el CTL_CONTEXT, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError. En la tabla siguiente se muestra un posible código de error.

Código devuelto	Descripción
E_INVALIDARG	Tipo de codificación de certificado no válido. Solo se admiten PKCS_7_ASN_ENCODING y X509_ASN_ENCODING.

Si se produce un error en la función, GetLastError puede devolver un error de codificación y descodificación de sintaxis abstracta uno (ASN.1). Para obtener información sobre estos errores, vea Valores devueltos de codificación y descodificación de ASN.1.

Comentarios

El CTL_CONTEXT debe liberarse llamando a CertFreeCTLContext. Se puede llamar a CertDuplicateCTLContext para hacer un duplicado. Se puede llamar a CertSetCTLContextProperty y CertGetCTLContextProperty para almacenar y leer las propiedades del CTL.

Requisitos

Requisito	Value
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