structure CTL_CONTEXT (wincrypt.h)

Article
08/27/2023

La structure CTL_CONTEXT contient à la fois les représentations encodées et décodées d’une CTL. Il contient également un handle HCRYPTMSG ouvert pour le message décodé, signé par chiffrement contenant le CTL_INFO comme contenu interne.

Les fonctions de message de bas niveau CryptoAPI peuvent être utilisées pour extraire des informations de signataire supplémentaires.

Une CTL_CONTEXT retournée par une fonction CryptoAPI doit être libérée en appelant la fonction CertFreeCTLContext .

Syntaxe

typedef struct _CTL_CONTEXT {
  DWORD      dwMsgAndCertEncodingType;
  BYTE       *pbCtlEncoded;
  DWORD      cbCtlEncoded;
  PCTL_INFO  pCtlInfo;
  HCERTSTORE hCertStore;
  HCRYPTMSG  hCryptMsg;
  BYTE       *pbCtlContent;
  DWORD      cbCtlContent;
} CTL_CONTEXT, *PCTL_CONTEXT;

Membres

dwMsgAndCertEncodingType

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

Les types d’encodage actuellement définis sont les suivants :

X509_ASN_ENCODING
PKCS_7_ASN_ENCODING

pbCtlEncoded

Pointeur vers la CTL encodée.

cbCtlEncoded

Taille, en octets, de la CTL encodée.

pCtlInfo

Pointeur vers CTL_INFO structure contenant les informations de la CTL.

hCertStore

Handle du magasin de certificats.

hCryptMsg

Ouvrez le handle HCRYPTMSG dans un message décodé signé par chiffrement contenant le CTL_INFO comme contenu interne.

pbCtlContent

Contenu interne encodé du message signé.

cbCtlContent

Nombre, en octets, de pbCtlContent.

Configuration requise


Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	wincrypt.h