Metodo IX509AttributeArchiveKeyHash::InitializeDecode (certenroll.h)

Il metodo InitializeDecode inizializza l'oggetto da una matrice di byte codificata Distinguished Encoding Rules (DER) che contiene un hash SHA-1 della chiave privata crittografata. 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 contenente il valore hash.

[in] strEncodedData

Variabile BSTR che contiene l'attributo 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. Per un elenco dei codici di errore comuni, vedere Valori HRESULT comuni.

Commenti

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

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

È necessario chiamare InitializeEncodeFromEncryptedKeyBlob o InitializeDecode prima di poter utilizzare un oggetto IX509AttributeArchiveKeyHash . I due metodi si integrano tra loro. Il metodo InitializeEncodeFromEncryptedKeyBlob consente di costruire una struttura ASN.1 codificata da dati non elaborati e il metodo InitializeDecode consente di inizializzare i dati non elaborati da una struttura ASN.1 codificata. È possibile chiamare la proprietà EncryptedKeyHashBlob per recuperare i dati non elaborati.

Requisiti

Vedi anche

IX509AttributeArchiveKeyHash