CertCreateCTLContext, fonction (wincrypt.h)

Article
08/27/2023

La fonction CertCreateCTLContext crée un contexte de liste de certificats d’approbation (CTL) à partir d’une CTL encodée. Le contexte créé n’est pas conservé dans un magasin de certificats. La fonction effectue une copie de la CTL encodée dans le contexte créé.

Syntaxe

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

Paramètres

[in] dwMsgAndCertEncodingType

Spécifie le type d’encodage utilisé. Les types d’encodage de certificat et de message doivent être spécifiés 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] pbCtlEncoded

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

[in] cbCtlEncoded

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

Valeur retournée

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

Si la fonction échoue et ne parvient pas à décoder et à créer le CTL_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. Seuls les PKCS_7_ASN_ENCODING et les X509_ASN_ENCODING sont 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 CTL_CONTEXT doit être libéré en appelant CertFreeCTLContext. CertDuplicateCTLContext peut être appelé pour créer un doublon. CertSetCTLContextProperty et CertGetCTLContextProperty peuvent être appelés pour stocker et lire les propriétés de la CTL.

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