Metodo IVMGuestOS::SetParameter

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

Imposta un parametro denominato all'interno del sistema operativo guest.

Sintassi

HRESULT SetParameter(
  [in] BSTR inParameterName,
  [in] BSTR inParameterValue
);

Parametri

inParameterName [in]

Nome del parametro. Deve avere una lunghezza compresa tra 1 e 255 caratteri e non può contenere una barra rovesciata (\).

inParameterValue [in]

Valore del parametro.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice/valore restituito	Descrizione
S_OK 0	L'operazione è stata completata.
E_INVALIDARG 0x80000003	Un parametro non è valido o non è specificato.
VM_E_TIMED_OUT 0xA0040202	L'operazione non è stata completata in modo tempestivo.
VM_E_VM_NOT_RUNNING 0xA0040206	La macchina virtuale (VM) non è in esecuzione.
VM_E_VM_PAUSED 0xA00400507	La macchina virtuale è sospesa.
VM_E_ADDITIONS_FEATURE_NOT_AVAIL 0xA0040505	I componenti di integrazione non vengono installati in questa macchina virtuale.
DISP_E_EXCEPTION 0x80020009	Si è verificato un errore imprevisto.

Commenti

La macchina virtuale deve essere in esecuzione e i componenti di integrazione devono essere installati quando questo metodo viene richiamato. Questo metodo è supportato solo per i sistemi operativi guest basati su Windows.

Con i componenti di integrazione installati, la chiave seguente viene aggiunta automaticamente al registro del sistema operativo guest:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Virtual Machine\Guest\Parameters

All'avvio del sistema operativo guest, nella chiave Parameters vengono popolati i valori di stringa del Registro di sistema seguenti:

• HostName
• PhysicalHostName
• PhysicalHostNameFullyQualified
• VirtualMachineName

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_IVMGuestOS è definito come 99fea0db-4880-499a-b6d8-73dff9bc91be

Vedi anche

IVMGuestOS