Funzione CertCreateCTLContext (wincrypt.h)

Articolo
03/13/2024

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