Metodo IX509ExtensionBasicConstraints::InitializeDecode (certenroll.h)

Articolo
03/14/2023

Il metodo InitializeDecode inizializza l'estensione da una matrice di byte codificata da Distinguished Encoding Rules (DER) che contiene il valore dell'estensione. La matrice di byte codificata è rappresentata da una stringa codificata Unicode.

Sintassi

HRESULT InitializeDecode(
  [in] EncodingType Encoding,
  [in] BSTR         strEncodedData
);

Parametri

[in] Encoding

Valore di enumerazione EncodingType che specifica il tipo di codifica Unicode applicato al valore strEncodedData .

[in] strEncodedData

Variabile BSTR contenente l'estensione con codifica DER.

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 di codici di errore comuni, vedere Valori HRESULT comuni.

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

Commenti

È possibile usare questo metodo se si dispone di un oggetto Sintassi astratta con codifica DER One (ASN.1) che contiene un'estensione BasicConstraints . È necessario specificare l'oggetto con codifica DER in una stringa codificata Unicode. Per altre informazioni, vedere l'interfaccia IBinaryConverter .

È necessario chiamare InitializeEncode o InitializeDecode prima di poter usare un oggetto IX509ExtensionBasicConstraints. I due metodi si integrano tra loro. Il metodo InitializeEncode consente di costruire un oggetto di estensione ASN.1 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'identificatore dell'oggetto (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


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