Partager via


structure CTL_CONTEXT (wincrypt.h)

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

Voir aussi

CTL_INFO

CertAddCTLContextToStore

CertAddEncodedCTLToStore

CertCreateCTLContext

CertEnumCTLsInStore

CertFindCTLInStore

CertFindSubjectInCTL

CertFreeCTLContext

CryptMsgGetAndVerifySigner

CryptMsgSignCTL