Metodo IX509ExtensionTemplateName::InitializeDecode (certenroll.h)

Articolo
02/28/2024

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 parametro 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 Notation One (ASN.1) con codifica DER che contiene un'estensione CertificateTemplateName . È 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 IX509ExtensionTemplateName. 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à TemplateName recupera il nome del modello (i dati dell'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

IX509ExtensionTemplateName

Condividi tramite