Metodo IX509AttributeOSVersion::InitializeDecode (certenroll.h)
Il metodo InitializeDecode inizializza l'oggetto da una matrice di byte codificata da Distinguished Encoding Rules (DER) contenente le informazioni sulla versione del sistema operativo. 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 applicato alla stringa di input.
[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 di codici di errore comuni, vedere Valori HRESULT comuni.
Commenti
L'identificatore dell'oggetto (OID) per questo attributo è XCN_OID_OS_VERSION (1.3.6.1.4.1.311.13.2.3). Per altre informazioni, vedere CERTENROLL_OBJECTID.
È possibile usare questo metodo se si dispone di un oggetto Sintassi astratta con codifica DER One (ASN.1) contenente il valore dell'attributo. È 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 IX509AttributeOSVersion. I due metodi si integrano tra loro. Il metodo InitializeEncode 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à OSVersion per recuperare i dati 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 |