Compartilhar via


Função CertCreateCRLContext (wincrypt.h)

A função CertCreateCRLContext cria um contexto de CRL (lista de revogação de certificado) de uma CRL codificada. O contexto criado não é persistido em um repositório de certificados. Ele faz uma cópia da CRL codificada dentro do contexto criado.

Sintaxe

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

Parâmetros

[in] dwCertEncodingType

Especifica o tipo de codificação usado. É sempre aceitável especificar os tipos de codificação de certificado e mensagem combinando-os com uma operação OR bit a bit, conforme mostrado no exemplo a seguir:

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING Tipos de codificação definidos no momento são:

  • X509_ASN_ENCODING
  • PKCS_7_ASN_ENCODING

[in] pbCrlEncoded

Um ponteiro para um buffer que contém a CRL codificada da qual o contexto deve ser criado.

[in] cbCrlEncoded

O tamanho, em bytes, do buffer pbCrlEncoded .

Retornar valor

Se a função for bem-sucedida, o valor retornado será um ponteiro para um CRL_CONTEXT somente leitura.

Se a função falhar e não conseguir decodificar e criar o CRL_CONTEXT, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError. A tabela a seguir mostra um possível código de erro.

Código de retorno Descrição
E_INVALIDARG
Tipo de codificação de certificado inválido. Atualmente, há suporte apenas para o tipo de codificação X509_ASN_ENCODING.
 

Se a função falhar, GetLastError poderá retornar um erro de codificação/decodificação de ASN.1 (Abstract Syntax Notation One ). Para obter informações sobre esses erros, consulte Codificação/Decodificação de Valores Retornados do ASN.1.

Comentários

O CRL_CONTEXT deve ser liberado chamando CertFreeCRLContext. CertDuplicateCRLContext pode ser chamado para tornar uma duplicata. CertSetCRLContextProperty e CertGetCRLContextProperty podem ser chamados para armazenar e ler propriedades para a CRL.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho wincrypt.h
Biblioteca Crypt32.lib
DLL Crypt32.dll

Confira também

CRL_CONTEXT

CertCreateCTLContext

CertCreateCertificateContext

CertDuplicateCRLContext

CertFreeCRLContext

CertGetCRLContextProperty

CertSetCRLContextProperty

Funções de lista de revogação de certificados