Metodo IVMVirtualPC::GetConfigurationValue

[PC virtuale Windows non è più disponibile per l'uso a partire da Windows 8. Usare invece il provider WMI Hyper-V (V2).]

Recupera il valore dell'impostazione di configurazione specificata.

Sintassi

HRESULT GetConfigurationValue(
  [in]          BSTR    preferenceKey,
  [out, retval] VARIANT *preferenceValue
);

Parametri

preferenceKey [in]

Chiave usata per identificare la preferenza, come archiviata nel file di configurazione.

preferenceValue [out, retval]

Valore preferenza. Questo parametro può essere uno dei tipi VARIANT seguenti: VT_ARRAY|VT_UI1 (byte non elaborati), VT_BSTR (stringa), VT_I4 (integer) o VT_BOOL (booleano).

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice/valore restituito	Descrizione
S_OK 0	L'operazione è stata completata.
E_POINTER 0x80004003	Il parametro preferenceKey o preferenceValue è NULL.
VM_E_PREF_NOT_FOUND 0xa0040300	La preferenza non è stata trovata.
VM_E_HARDWARE_VIRTUALIZATION_DISABLED 0xA0040951	Il processore non supporta le estensioni HAV (Hardware Accelerated Virtualization).
DISP_E_EXCEPTION 0x80020009	Si è verificato un errore imprevisto.

Commenti

Questo metodo consente l'accesso di basso livello a qualsiasi valore di preferenza per l'utente corrente. Può essere usato per recuperare i valori delle preferenze per le chiavi definite dal cliente.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Nessuno supportato
Fine del supporto client	Windows 7
Prodotto	Windows Virtual PC
Intestazione	VPCCOMInterfaces.h
IID	IID_IVMVirtualPC è definito come 236ba0d9-a24a-4292-a132-27c1421dfd01

Vedi anche

IVMVirtualPC