Metodo IX509ExtensionTemplate::InitializeDecode (certenroll.h)

Il metodo InitializeDecode inizializza l'estensione da una matrice di byte con codifica 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.

Commenti

È possibile usare questo metodo se si dispone di un oggetto Sintassi astratta con codifica ASN.1 (ASN.1) con codifica Distinguished Encoding Rules ASN.1 che contiene un'estensione CertificateTemplate. È 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 IX509ExtensionTemplate. 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).
• Le proprietà MajorVersion e MinorVersion recuperano le informazioni sulla versione.
• La proprietà TemplateOid recupera l'OID del modello.

Requisiti

Vedi anche

IX509ExtensionTemplate