IVMGuestOS::Shutdown-Methode

  • Artikel

[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