Funzione CertCreateCRLContext (wincrypt.h)

Articolo
03/15/2023

La funzione CertCreateCRLContext crea un contesto di elenco di revoche di certificati (CRL) da un CRL codificato. Il contesto creato non viene salvato in modo permanente in un archivio certificati. Crea una copia del CRL codificato all'interno del contesto creato.

Sintassi

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

Parametri

[in] dwCertEncodingType

Specifica il tipo di codifica utilizzata. È sempre accettabile specificare sia il certificato che i tipi di codifica dei messaggi combinandoli con un'operazione OR bit per bit, come illustrato nell'esempio seguente:

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING I tipi di codifica attualmente definiti sono:

X509_ASN_ENCODING
PKCS_7_ASN_ENCODING

[in] pbCrlEncoded

Puntatore a un buffer contenente il CRL codificato da cui creare il contesto.

[in] cbCrlEncoded

Dimensione, in byte, del buffer pbCrlEncoded .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un puntatore a un CRL_CONTEXT di sola lettura.

Se la funzione ha esito negativo e non è in grado di decodificare e creare il CRL_CONTEXT, il valore restituito è NULL. Per informazioni sugli errori estesi, chiamare GetLastError. Nella tabella seguente viene illustrato un codice di errore possibile.

Codice restituito	Descrizione
E_INVALIDARG	Tipo di codifica del certificato non valido. Attualmente è supportato solo il tipo di codifica X509_ASN_ENCODING.

Se la funzione ha esito negativo, GetLastError può restituire un errore di codifica/decodifica ASN.1 ( Abstract Syntax Notation One ). Per informazioni su questi errori, vedere Codifica ASN.1/Decodifica dei valori restituiti.

Commenti

Il CRL_CONTEXT deve essere liberato chiamando CertFreeCRLContext. CertDuplicateCRLContext può essere chiamato per creare un duplicato. È possibile chiamare CertSetCRLContextProperty e CertGetCRLContextProperty per archiviare e leggere le proprietà per CRL.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [app desktop \| App UWP]
Server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	wincrypt.h
Libreria	Crypt32.lib
DLL	Crypt32.dll