IVMGuestOS::Shutdown-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).]

Fährt das Gastbetriebssystem auf dem virtuellen Computer herunter.

Syntax

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

Parameter

isForced [ In]

VARIANT _ TRUE, wenn das Herunterfahren erzwungen werden soll, andernfalls VARIANT _ FALSE.

outShutdownTask [ out, retval]

Ein IVMTask-Objekt, mit dem der Abschluss des Herunterfahrens nachverfolgt wird.

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 wurde nicht gefunden.
VM _ E _ VM WIRD NICHT _ _ AUSGEFÜHRT,
0xA0040206
Der virtuelle Computer 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
Die Integrationskomponentenfunktion ist auf diesem virtuellen Computer nicht installiert.
DISP _ E _ EXCEPTION
0x80020009
Ein unerwarteter Fehler ist aufgetreten.

Hinweise

Der virtuelle Computer muss ausgeführt werden, und die Integrationskomponentenfunktion muss installiert werden, 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 Force 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 Herunterfahren des Systems wird ausgeführt.

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 _ IVMGuestOS ist als 99fea0db-4880-499a-b6d8-73dff9bc91be definiert.

Siehe auch

IVMGuestOS