Metodo IVMGuestOS::GetParameter

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

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

Sintassi

HRESULT GetParameter(
  [in]          BSTR inParameterName,
  [out, retval] BSTR *outParameterValue
);

Parametri

inParameterName [in]

Nome del parametro. Deve essere compreso tra 1 e 255 caratteri in lunghezza e non può contenere un carattere barra rovesciata (\).

outParameterValue [out , retval]

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.
E_POINTER 0x80004003	Il parametro è NULL.
VM_E_TIMED_OUT 0xA0040202	L'operazione non è stata completata in modo tempestivo.
VM_E_VM_NOT_RUNNING 0xA0040206	La macchina virtuale non è in esecuzione.
VM_E_VM_PAUSED 0xA00400507	La macchina virtuale viene 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 di sistema operativo guest:

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

Quando il sistema operativo guest viene avviato, i valori della stringa del Registro di sistema seguenti vengono popolati nella chiave Parametri:

• 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