Metodo IX509ExtensionBasicConstraints::InitializeEncode (certenroll.h)

Articolo
03/05/2024

Il metodo InitializeEncode inizializza l'estensione da un valore booleano che indica se l'oggetto del certificato è un'autorità di certificazione (CA) e un numero intero che contiene la profondità della catena CA subordinata.

Sintassi

HRESULT InitializeEncode(
  [in] VARIANT_BOOL IsCA,
  [in] LONG         PathLenConstraint
);

Parametri

[in] IsCA

Variabile VARIANT_BOOL che specifica se l'oggetto del certificato è una CA.

[in] PathLenConstraint

Variabile LONG contenente il numero massimo di certificati nella catena.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce S_OK.

Se la funzione ha esito negativo, restituisce un valore HRESULT che indica l'errore. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente. Per un elenco dei codici di errore comuni, vedere Valori HRESULT comuni.

Codice/valore restituito	Descrizione
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	L'oggetto è già inizializzato.

Commenti

Il metodo associa la raccolta dei nomi all'identificatore di oggetto (OID) XCN_OID_BASIC_CONSTRAINTS2 (2.5.29.19) e lo codifica usando Distinguished Encoding Rules (DER).

È necessario chiamare InitializeEncode o InitializeDecode prima di poter utilizzare un oggetto IX509ExtensionBasicConstraints . I due metodi si integrano tra loro. Il metodo InitializeEncode consente di costruire un oggetto di estensione ASN.1 ( Abstract Syntax Notation One ) con codifica DER dai dati non elaborati e il metodo InitializeDecode consente di inizializzare i dati non elaborati da un oggetto codificato.

È possibile recuperare le proprietà seguenti per questa estensione:

La proprietà Critical identifica se l'estensione è critica. È anche possibile specificare questa proprietà.
La proprietà ObjectId recupera l'OID.
La proprietà IsCA identifica se l'oggetto del certificato può essere un'autorità di certificazione.
La proprietà PathLenConstraint identifica la profondità della catena di autorità di certificazione subordinata.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	certenroll.h
DLL	CertEnroll.dll

Vedi anche

IX509ExtensionBasicConstraints

Condividi tramite