Metodo IX509ExtensionEnhancedKeyUsage::InitializeDecode (certenroll.h)
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 |
---|---|
|
L'oggetto è già inizializzato. |
Commenti
È possibile usare questo metodo se si dispone di un oggetto Sintassi astratta con codifica DER (ASN.1) che contiene un'estensione EnhancedKeyUsage . È 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 IX509ExtensionEnhancedKeyUsage. 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 estensione (OID).
- La proprietà EnhancedKeyUsage recupera la raccolta di OID che identificano gli usi previsti della chiave pubblica (i 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 |