Metodo IVMGuestOS::Shutdown

Articolo
06/13/2023

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

Arresta il sistema operativo guest nella macchina virtuale.

Sintassi

HRESULT Shutdown(
  [in]          VARIANT_BOOL isForced,
  [out, retval] IVMTask      **outShutdownTask
);

Parametri

isForced [in]: VARIANT_TRUE se l'arresto deve essere forzato, VARIANT_FALSE in caso contrario.
outShutdownTask [out, retval]: Oggetto IVMTask utilizzato per tenere traccia del completamento del processo di arresto.

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 outShutdownTask è NULL.
VM_E_TIMED_OUT 0xA0040202	L'operazione non è stata completata in modo tempestivo.
VM_E_VM_UNKNOWN 0xA0040207	Impossibile trovare la macchina virtuale.
VM_E_VM_NOT_RUNNING 0xA0040206	La macchina virtuale deve essere in esecuzione per questa operazione.
HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED) 0x80070005	Il chiamante deve disporre delle autorizzazioni di accesso per l'esecuzione per questa macchina virtuale.
VM_E_ADDITIONS_FEATURE_NOT_AVAIL 0xA0040505	La funzionalità dei componenti di integrazione non è installata in questa macchina virtuale.
DISP_E_EXCEPTION 0x80020009	Si è verificato un errore imprevisto.

Commenti

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

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 l'esecuzione 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)	È in corso un arresto del sistema.

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

Condividi tramite