IVMVirtualMachine::TurnOff-Methode

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

Der virtuelle Computer wird heruntergefahren.

Syntax

HRESULT TurnOff(
  [out, retval] IVMTask **turnOffTask
);

turnOffTask [out, retval]: Ein IVMTask-Objekt , das verwendet wird, um den Abschlussstatus der Turnoffsequenz des virtuellen Computers nachzuverfolgen.

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode/-wert	BESCHREIBUNG
S_OK 0	Der Vorgang wurde durchgeführt.
E_POINTER 0x80004003	Der Parameter ist NULL.
HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED) 0x80070005	Der Aufrufer muss über Ausführungszugriffsberechtigungen verfügen, um diesen virtuellen Computer zu deaktivieren.
VM_E_VM_NOT_RUNNING 0xA0040206	Der virtuelle Computer wird nicht ausgeführt.
VM_E_VM_UNKNOWN 0xA0040207	Die Konfiguration ist unbekannt.
DISP_E_EXCEPTION 0x80020009	Ein unerwarteter Fehler ist aufgetreten.

Diese Methode deaktiviert den virtuellen Computer auf die gleiche Weise wie das Ausschalten auf einem physischen Computer.

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_IVMVirtualMachine ist definiert als f7092aa1-33ed-4f78-a59f-c00adfc2edd7