Metodo IX509ExtensionAlternativeNames::InitializeDecode (certenroll.h)

Articolo
02/23/2024

Il metodo InitializeDecode inizializza l'estensione da una matrice di byte codificata Distinguished Encoding Rules (DER) che contiene il valore di estensione. La matrice di byte codificata è rappresentata da una stringa con codifica 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 che contiene 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 dei codici di errore comuni, vedere Valori HRESULT comuni.

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

Commenti

È possibile utilizzare questo metodo se si dispone di un oggetto ASN.1 ( Abstract Syntax Notation One ) con codifica DER che contiene un'estensione AlternativeNames . È necessario specificare l'oggetto con codifica DER in una stringa con codifica Unicode. Per altre informazioni, vedere l'interfaccia IBinaryConverter .

È necessario chiamare InitializeEncode o InitializeDecode prima di poter utilizzare un oggetto IX509ExtensionAlternativeNames . I due metodi si integrano tra loro. Il metodo InitializeEncode consente di costruire un oggetto di estensione ASN.1 con codifica DER da 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à AlternativeNames recupera la raccolta di nomi (dati di estensione non elaborati).

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

IX509ExtensionAlternativeNames

Condividi tramite