Metodo IX509AttributeExtensions::InitializeDecode (certenroll.h)

  • Articolo

Il metodo InitializeDecode inizializza l'oggetto da una matrice di byte codificata Distinguished Encoding Rules (DER) che contiene il valore dell'attributo. La matrice di byte è 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 applicata alla stringa di input.

[in] strEncodedData

Variabile BSTR che contiene le estensioni codificate.

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

Commenti

L'identificatore di oggetto (OID) per questo attributo è XCN_OID_RSA_certExtensions (1.2.840.113549.1.9.14). Per altre informazioni, vedere CERTENROLL_OBJECTID.

È possibile utilizzare questo metodo se si dispone di un oggetto ASN.1 con codifica DER che contiene un valore di attributo. È 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 IX509AttributeExtensions . I due metodi si integrano tra loro. Il metodo InitializeEncode consente di costruire una struttura ASN.1 ( Abstract Syntax Notation One ) codificata da dati non elaborati e il metodo InitializeDecode consente di inizializzare i dati non elaborati da una struttura ASN.1 codificata che contiene le estensioni del certificato. È possibile chiamare la proprietà X509Extensions per recuperare le estensioni.

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

IBinaryConverter

IX509Attribute

IX509AttributeExtensions

IX509Attributes