Función CertCreateCRLContext (wincrypt.h)

Artículo
03/13/2024

La función CertCreateCRLContext crea un contexto de lista de revocación de certificados (CRL) a partir de una CRL codificada. El contexto creado no se conserva en un almacén de certificados. Realiza una copia de la CRL codificada en el contexto creado.

Sintaxis

PCCRL_CONTEXT CertCreateCRLContext(
  [in] DWORD      dwCertEncodingType,
  [in] const BYTE *pbCrlEncoded,
  [in] DWORD      cbCrlEncoded
);

Parámetros

[in] dwCertEncodingType

Especifica el tipo de codificación usada. Siempre es aceptable especificar los tipos de codificación de certificados y mensajes al combinarlos 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] pbCrlEncoded

Puntero a un búfer que contiene la CRL codificada desde la que se va a crear el contexto.

[in] cbCrlEncoded

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

Valor devuelto

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

Si se produce un error en la función y no se puede descodificar y crear el CRL_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. Actualmente, solo se admite el tipo de codificación 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/descodificación de ASN.1.

Comentarios

El CRL_CONTEXT debe liberarse llamando a CertFreeCRLContext. Se puede llamar a CertDuplicateCRLContext para hacer un duplicado. Se puede llamar a CertSetCRLContextProperty y CertGetCRLContextProperty para almacenar y leer las propiedades de la CRL.

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