Partager via


Fonction CertCreateCRLContext (wincrypt.h)

La fonction CertCreateCRLContext crée un contexte de liste de révocation de certificats (CRL) à partir d’une liste de révocation de certificats encodée. Le contexte créé n’est pas conservé dans un magasin de certificats. Il effectue une copie de la liste de révocation de certificats encodée dans le contexte créé.

Syntaxe

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

Paramètres

[in] dwCertEncodingType

Spécifie le type d’encodage utilisé. Il est toujours acceptable de spécifier les types d’encodage de certificat et de message en les combinant avec une opération OR au niveau du bit, comme illustré dans l’exemple suivant :

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING types d’encodage actuellement définis sont les suivants :

  • X509_ASN_ENCODING
  • PKCS_7_ASN_ENCODING

[in] pbCrlEncoded

Pointeur vers une mémoire tampon contenant la liste de révocation de certificats encodée à partir de laquelle le contexte doit être créé.

[in] cbCrlEncoded

Taille, en octets, de la mémoire tampon pbCrlEncoded .

Valeur retournée

Si la fonction réussit, la valeur de retour est un pointeur vers un CRL_CONTEXT en lecture seule.

Si la fonction échoue et ne parvient pas à décoder et à créer le CRL_CONTEXT, la valeur de retour est NULL. Pour obtenir des informations d’erreur étendues, appelez GetLastError. Le tableau suivant présente un code d’erreur possible.

Code de retour Description
E_INVALIDARG
Type d’encodage de certificat non valide. Actuellement, seul le type d’encodage X509_ASN_ENCODING est pris en charge.
 

Si la fonction échoue, GetLastError peut renvoyer une erreur d’encodage/décodage ASN.1 ( Abstract Syntax Notation One ). Pour plus d’informations sur ces erreurs, consultez Valeurs de retour d’encodage/décodage ASN.1.

Remarques

Le CRL_CONTEXT doit être libéré en appelant CertFreeCRLContext. CertDuplicateCRLContext peut être appelé pour créer un doublon. CertSetCRLContextProperty et CertGetCRLContextProperty peuvent être appelés pour stocker et lire les propriétés de la liste de révocation de certificats.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête wincrypt.h
Bibliothèque Crypt32.lib
DLL Crypt32.dll

Voir aussi

CRL_CONTEXT

CertCreateCTLContext

CertCreateCertificateContext

CertDuplicateCRLContext

CertFreeCRLContext

CertGetCRLContextProperty

CertSetCRLContextProperty

Fonctions de liste de révocation de certificats