Condividi tramite


Funzione CertCreateCTLContext (wincrypt.h)

La funzione CertCreateCTLContext crea un contesto CTL ( Certificate Trust List ) da un CTL codificato. Il contesto creato non viene mantenuto in modo permanente in un archivio certificati. La funzione crea una copia del CTL codificato nel contesto creato.

Sintassi

PCCTL_CONTEXT CertCreateCTLContext(
  [in] DWORD      dwMsgAndCertEncodingType,
  [in] const BYTE *pbCtlEncoded,
  [in] DWORD      cbCtlEncoded
);

Parametri

[in] dwMsgAndCertEncodingType

Specifica il tipo di codifica usato. Sia i tipi di codifica del certificato che dei messaggi devono essere specificati combinandoli con un'operazione BIT-OR , come illustrato nell'esempio seguente:

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING Tipi di codifica attualmente definiti sono:

  • X509_ASN_ENCODING
  • PKCS_7_ASN_ENCODING

[in] pbCtlEncoded

Puntatore a un buffer contenente il CTL codificato da cui creare il contesto.

[in] cbCtlEncoded

Dimensioni, in byte, del buffer pbCtlEncoded .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un puntatore a un CTL_CONTEXT di sola lettura.

Se la funzione ha esito negativo e non è in grado di decodificare e creare il CTL_CONTEXT, il valore restituito è NULL. Per informazioni sull'errore estese, chiamare GetLastError. La tabella seguente mostra un codice di errore possibile.

Codice restituito Descrizione
E_INVALIDARG
Tipo di codifica del certificato non valido. Sono supportati solo PKCS_7_ASN_ENCODING e X509_ASN_ENCODING.
 

Se la funzione ha esito negativo, GetLastError potrebbe restituire un errore di codifica astratta Notation One (ASN.1). Per informazioni su questi errori, vedere Codifica ASN.1/Decodifica dei valori restituiti.

Commenti

Il CTL_CONTEXT deve essere liberato chiamando CertFreeCTLContext. CertDuplicateCTLContext può essere chiamato per creare un duplicato. CertSetCTLContextProperty e CertGetCTLContextProperty può essere chiamato per archiviare e leggere le proprietà per il CTL.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [app desktop | App UWP]
Server minimo supportato Windows Server 2003 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione wincrypt.h
Libreria Crypt32.lib
DLL Crypt32.dll

Vedi anche

CTL_CONTEXT

CertCreateCRLContext

CertCreateCertificateContext

CertDuplicateCTLContext

CertFreeCTLContext

CertGetCTLContextProperty

CertSetCTLContextProperty

Funzioni elenco attendibili certificati