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

Vedi anche

CTL_INFO

CertAddCTLContextToStore

CertAddEncodedCTLToStore

CertCreateCTLContext

CertEnumCTLsInStore

CertFindCTLInStore

CertFindSubjectInCTL

CertFreeCTLContext

CryptMsgGetAndVerifySigner

CryptMsgSignCTL