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 |