struttura CTL_CONTEXT (wincrypt.h)
La struttura CTL_CONTEXT contiene sia le rappresentazioni codificate che decodificate di un CTL. Contiene anche un handle HCRYPTMSG aperto per il messaggio crittografato con firma crittografica contenente il CTL_INFO come contenuto interno.
Le funzioni di messaggio di basso livello cryptoAPI possono essere usate per estrarre informazioni aggiuntive sul firmatario.
Un CTL_CONTEXT restituito da qualsiasi funzione CryptoAPI deve essere liberato chiamando la funzione CertFreeCTLContext .
Sintassi
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;
Members
dwMsgAndCertEncodingType
Tipo di codifica utilizzata. È sempre accettabile specificare sia il certificato che i tipi di codifica dei messaggi combinandoli con un'operazione OR bit per bit, come illustrato nell'esempio seguente:
X509_ASN_ENCODING | PKCS_7_ASN_ENCODING
I tipi di codifica attualmente definiti sono:
- X509_ASN_ENCODING
- PKCS_7_ASN_ENCODING
pbCtlEncoded
Puntatore al CTL codificato.
cbCtlEncoded
Dimensione, in byte, del CTL codificato.
pCtlInfo
Un puntatore alla struttura CTL_INFO contiene le informazioni sulla durata (CTL).
hCertStore
Handle per l'archivio certificati.
hCryptMsg
Aprire l'handle HCRYPTMSG in un messaggio crittografato con firma crittografica contenente il CTL_INFO come contenuto interno.
pbCtlContent
Contenuto interno codificato del messaggio firmato.
cbCtlContent
Conteggio, in byte, di pbCtlContent.
Requisiti
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Intestazione | wincrypt.h |