Metodo IVMGuestOS::Restart

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

Riavvia il sistema operativo guest.

Sintassi

HRESULT Restart(
  [in]          VARIANT_BOOL inForced,
  [out, retval] IVMTask      **outRestartTask
);

inForced [in]: VARIANT_TRUE se è necessario un riavvio forzato e VARIANT_FALSE in caso contrario.
outRestartTask [out , retval]: Oggetto IVMTask usato per tenere traccia dello stato di completamento della sequenza di riavvio.

Questo metodo può restituire uno di questi valori.

Codice/valore restituito	Descrizione
S_OK 0	L'operazione è stata completata.
E_POINTER 0x80004003	Il parametro outRestartTask è NULL.
DISP_E_EXCEPTION 0x80020009	Si è verificato un errore imprevisto.
VM_E_TIMED_OUT 0xA0040202	L'operazione non è stata completata in modo tempestivo.
VM_E_VM_NOT_RUNNING 0xA0040206	La macchina virtuale deve essere in esecuzione per questa operazione.
VM_E_VM_UNKNOWN 0xA0040207	La configurazione è sconosciuta.
VM_E_ADDITIONS_FEATURE_NOT_AVAIL 0xA0040505	La funzionalità dei componenti di integrazione non è installata in questa macchina virtuale.

I valori seguenti possono essere restituiti tramite la proprietà Error dell'oggetto IVMTask restituito.

Codice errore/valore	Descrizione
`HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED)` (0x80070005)	Il chiamante deve disporre delle autorizzazioni di accesso per questa macchina virtuale.
`HRESULT_FROM_WIN32(ERROR_MACHINE_LOCKED)` (0x800704f7)	Il computer è bloccato e non può essere arrestato senza l'opzione forza.
`HRESULT_FROM_WIN32(ERROR_NOT_READY)` (0x80070015)	Il dispositivo non è pronto.
`HRESULT_FROM_WIN32(ERROR_SHUTDOWN_IN_PROGRESS)` (0x8007045b)	Un arresto del sistema è in corso.

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