IVMGuestOS::Restart-Methode

[Windows Der virtuelle PC ist ab diesem Zeitraum nicht mehr Windows 8. Verwenden Sie stattdessen den Hyper-V-WMI-Anbieter (V2).]

Startet das Gastbetriebssystem neu.

Syntax

HRESULT Restart(
  [in]          VARIANT_BOOL inForced,
  [out, retval] IVMTask      **outRestartTask
);

Parameter

inForced [ In]

VARIANT _ TRUE, wenn ein erzwungener Neustart erforderlich ist, andernfalls VARIANT _ FALSE.

outRestartTask [ out, retval]

Ein IVMTask-Objekt, das zum Nachverfolgen des Abschlussfortschritts der Neustartsequenz verwendet wird.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode/-wert BESCHREIBUNG
S _ OK
0
Der Vorgang wurde durchgeführt.
E _ ZEIGER 0X80004003
Der outRestartTask-Parameter ist NULL.
DISP _ E _ EXCEPTION
0x80020009
Ein unerwarteter Fehler ist aufgetreten.
VM _ E _ TIMED _ OUT
0xA0040202
Der Vorgang wurde nicht rechtzeitig abgeschlossen.
VM _ E _ VM _ NOT _ RUNNING
0xA0040206
Der virtuelle Computer (VM) muss für diesen Vorgang ausgeführt werden.
VM _ E _ VM _ UNKNOWN
0xA0040207
Die Konfiguration ist unbekannt.
VM _ E _ ADDITIONS _ FEATURE NOT _ _ AVAIL
0XA0040505
Die Integrationskomponentenfunktion ist auf diesem virtuellen Computer nicht installiert.

Bemerkungen

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 nicht ohne die Force-Option 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 heruntergefahren.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 7 [ 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 als 99fea0db-4880-499a-b6d8-73dff9bc91be definiert.

Weitere Informationen

IVMGuestOS