Msvm_GuestService::RequestStateChange-Methode

Artikel
07/03/2023

Fordert an, dass der Status des Gastdiensts in den angegebenen Wert geändert wird.

Syntax

uint32 RequestStateChange(
  [in]  uint16              RequestedState,
  [out] CIM_ConcreteJob Job,
  [in]  datetime            TimeoutPeriod
);

Parameter

RequestedState [in]: Der neue Zustand. Die Informationen werden in der RequestedState-Eigenschaft des instance platziert, wenn der Rückgabecode der RequestStateChange-Methode 0 oder 4096 ist. Weitere Informationen finden Sie in der Beschreibung der Eigenschaften EnabledState und RequestedState für das Element. Dies muss einer der folgenden Werte sein.
Aktiviert (2)
Deaktiviert (3)
Herunterfahren (4)
Offline (6)
Test (7)
Zurückstellen (8)
Stilllegen (9)
Neustart (10)
Zurücksetzen (11)
DMTF Reserviert (..)
Anbieter reserviert (32768..65535)

Auftrag [out]

Ein optionaler Verweis auf ein CIM_ConcreteJob-Objekt , das zurückgegeben wird, wenn der Vorgang asynchron ausgeführt wird. Falls vorhanden, kann der zurückgegebene Verweis verwendet werden, um den Fortschritt zu überwachen und das Ergebnis der Methode zu erhalten.

TimeoutPeriod [in]

Ein Timeoutzeitraum, der die maximale Zeitspanne angibt, die der Client für den Übergang in den neuen Zustand erwartet. Das Intervallformat muss verwendet werden, um den Timeoutzeitraum anzugeben. Der Wert 0 oder Null gibt an, dass der Client keine Zeitanforderungen für den Übergang hat. Wenn diese Eigenschaft nicht 0 oder Null enthält und die Implementierung diesen Parameter nicht unterstützt, muss der Rückgabecode 4098 (Verwendung des Timeoutparameters nicht unterstützt) zurückgegeben werden.

Rückgabewert

Diese Methode gibt einen der folgenden Werte zurück.

Rückgabecode/-wert	BESCHREIBUNG
Abgeschlossen ohne Fehler 0	Erfolg.
Nicht unterstützt 1
Methodenparameter überprüft – Übergang gestartet 4096	Der Übergang erfolgt asynchron.
Verwendung des Timeoutparameters wird nicht unterstützt 4098
Zugriff verweigert 32769	Zugriff verweigert.
Ungültiger Status für diesen Vorgang 32775	Der im RequestedState-Parameter angegebene Wert wird nicht unterstützt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8.1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 R2 [nur Desktop-Apps]
Namespace	\\Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

Siehe auch

Msvm_GuestService

Freigeben über