IVMGuestOS::Restart-Methode
[Windows Virtual PC ist ab Windows 8 nicht mehr verfügbar. 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, und 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 |
|---|---|
|
Der Vorgang wurde durchgeführt. |
|
Der outRestartTask-Parameter ist NULL. |
|
Ein unerwarteter Fehler ist aufgetreten. |
|
Der Vorgang wurde nicht rechtzeitig abgeschlossen. |
|
Der virtuelle Computer (VM) muss für diesen Vorgang ausgeführt werden. |
|
Die Konfiguration ist unbekannt. |
|
Das Feature "Integrationskomponenten" 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 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 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 |
|
| IID |
IID_IVMGuestOS ist definiert als 99fea0db-4880-499a-b6d8-73dff9bc91be |