IVMGuestOS::Shutdown-Methode

Artikel
06/13/2023

[Windows Virtual PC ist ab Windows 8 nicht mehr verfügbar. Verwenden Sie stattdessen den Hyper-V WMI-Anbieter (V2).]

Fährt das Gastbetriebssystem auf dem virtuellen Computer (VM) herunter.

Syntax

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

Parameter

isForced [in]: VARIANT_TRUE , wenn das Herunterfahren erzwungen werden soll, VARIANT_FALSE andernfalls.
outShutdownTask [out, retval]: Ein IVMTask-Objekt , das verwendet wird, um den Abschluss des Herunterfahrens nachzuverfolgen.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode/-wert	BESCHREIBUNG
S_OK 0	Der Vorgang wurde durchgeführt.
E_POINTER 0x80004003	Der outShutdownTask-Parameter ist NULL.
VM_E_TIMED_OUT 0xA0040202	Der Vorgang wurde nicht rechtzeitig abgeschlossen.
VM_E_VM_UNKNOWN 0xA0040207	Der virtuelle Computer konnte nicht gefunden werden.
VM_E_VM_NOT_RUNNING 0xA0040206	Die VM muss für diesen Vorgang ausgeführt werden.
HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED) 0x80070005	Der Aufrufer muss über Ausführungszugriffsberechtigungen für diesen virtuellen Computer verfügen.
VM_E_ADDITIONS_FEATURE_NOT_AVAIL 0xA0040505	Das Feature "Integrationskomponenten" ist auf diesem virtuellen Computer nicht installiert.
DISP_E_EXCEPTION 0x80020009	Ein unerwarteter Fehler ist aufgetreten.

Bemerkungen

Der virtuelle Computer muss ausgeführt werden, und die Integrationskomponentenfunktion muss installiert sein, wenn diese Methode aufgerufen wird. Diese Methode wird nur für Windows-basierte Gastbetriebssysteme unterstützt.

Die folgenden Werte können über die Error-Eigenschaft des zurückgegebenen IVMTask-Objekts zurückgegeben werden.

Fehlercode/- wert	Beschreibung
`HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED)` (0x80070005)	Der Aufrufer muss über Ausführungszugriffsberechtigungen für diesen virtuellen Computer verfügen.
`HRESULT_FROM_WIN32(ERROR_MACHINE_LOCKED)` (0x800704f7)	Der Computer ist gesperrt und kann ohne die Option "Erzwingen" nicht heruntergefahren werden.
`HRESULT_FROM_WIN32(ERROR_NOT_READY)` (0x80070015)	Das Gerät ist nicht bereit.
`HRESULT_FROM_WIN32(ERROR_SHUTDOWN_IN_PROGRESS)` (0x8007045b)	Das System wird gerade heruntergefahren.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Ende des Supports (Client)	Windows 7
Produkt	Windows Virtual PC
Header	VPCCOMInterfaces.h
IID	IID_IVMGuestOS ist definiert als 99fea0db-4880-499a-b6d8-73dff9bc91be

Siehe auch

IVMGuestOS

Freigeben über