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 |
|---|---|
|
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 |