Metodo IX509AttributeOSVersion::InitializeEncode (certenroll.h)

  • Articolo

Il metodo InitializeEncode inizializza l'attributo dalle informazioni sulla versione del sistema operativo.

Sintassi

HRESULT InitializeEncode(
  [in, optional] BSTR strOSVersion
);

Parametri

[in, optional] strOSVersion

Variabile BSTR contenente le informazioni sulla versione. Il formato della stringa è major.minor.build.platform. Questo parametro è facoltativo e, Se non si specifica una stringa, questo metodo chiama la funzione GetVersionEx .

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_OS_VERSION (1.3.6.1.4.1.311.13.2.3). Per altre informazioni, vedere CERTENROLL_OBJECTID.

È necessario chiamare InitializeEncode o InitializeDecode prima di poter utilizzare un oggetto IX509AttributeOSVersion . 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. È 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

Vedi anche

IX509AttributeOSVersion