IVMVirtualMachine::TurnOff-Methode

[Windows Der virtuelle PC ist ab Windows 8 nicht mehr für die Verwendung verfügbar. Verwenden Sie stattdessen den Hyper-V-WMI-Anbieter (V2).]

Der virtuelle Computer wird heruntergefahren.

Syntax

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

Parameter

turnOffTask [ out, retval]

Ein IVMTask-Objekt, das verwendet wird, um den Abschlussfortschritt der Turnoffsequenz des virtuellen Computers 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 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 WIRD NICHT _ _ AUSGEFÜHRT,
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.

Hinweise

Diese Methode schaltet den virtuellen Computer auf die gleiche Weise wie das Ausschalten eines physischen Computers aus.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
nur Windows 7 [ Desktop-Apps]
Unterstützte Mindestversion (Server)
Nicht unterstützt
Ende des Supports (Client)
Windows 7
Product (Produkt)
Windows Virtual PC
Header
VPCCOMInterfaces.h
IID
IID _ IVMVirtualMachine ist als f7092aa1-33ed-4f78-a59f-c00adfc2edd7 definiert.

Siehe auch

IVMVirtualMachine