IVMVirtualMachine::ShutdownActionOnQuit-Eigenschaft

  • Artikel

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

Ruft die Aktion ab, die auf diesem virtuellen Computer (VM) ausgeführt werden soll, wenn sie ausgeführt wird, wenn Windows Virtual PC beendet wird, und legt sie fest.

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT put_ShutdownActionOnQuit(
  [in]          VMShutdownAction shutdownAction
);

HRESULT get_ShutdownActionOnQuit(
  [out, retval] VMShutdownAction *shutdownAction
);

Eigenschaftswert

Gibt an, wie dieser virtuelle Computer heruntergefahren wird, wenn er ausgeführt wird, wenn Windows Virtual PC beendet wird. Eine Liste der Werte finden Sie unter VMShutdownAction.

Fehlercodes

Name/Wert Bedeutung
S_OK
0
 Der Vorgang wurde durchgeführt.
E_POINTER
0x80004003
 Der Parameter ist NULL oder kein gültiger Wert.
E_ACCESSDENIED
0x80070005
 Der aktuelle Benutzer hat nicht genügend Zugriff auf die Konfigurationsdatei.
VM_E_VM_UNKNOWN
0xA0040207
 Die Konfiguration ist unbekannt.
DISP_E_EXCEPTION
0x80020009
 Ein unerwarteter Fehler ist aufgetreten.

Bemerkungen

Standardmäßig werden ausgeführte VMs gespeichert, wenn Windows Virtual PC beendet wird. Die Aktion zum Herunterfahren vmShutdownAction_Save (0) speichert den Zustand des virtuellen Computers. Die aktion vmShutdownAction_TurnOff (1) deaktiviert den virtuellen Computer. Die aktion vmShutdownAction_Shutdown (2) beendet das Gastbetriebssystem, wenn die Integrationskomponenten verfügbar sind, und speichert den virtuellen Computer andernfalls.

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

Siehe auch

IVMVirtualMachine

VMShutdownAction