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 |
|---|---|
|
Der Vorgang wurde durchgeführt. |
|
Der outShutdownTask-Parameter ist NULL. |
|
Der Vorgang wurde nicht rechtzeitig abgeschlossen. |
|
Der virtuelle Computer wurde nicht gefunden. |
|
Der virtuelle Computer muss für diesen Vorgang ausgeführt werden. |
|
Der Aufrufer muss über Ausführungszugriffsberechtigungen für diesen virtuellen Computer verfügen. |
|
Die Integrationskomponentenfunktion ist auf diesem virtuellen Computer nicht installiert. |
|
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.
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 |
|
| IID |
IID _ IVMGuestOS ist als 99fea0db-4880-499a-b6d8-73dff9bc91be definiert. |