Msvm_GuestServiceInterfaceComponent::RequestStateChange-Methode

Artikel
06/13/2023

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

Syntax

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

Parameter

RequestedState [in]

Typ: uint16

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]

Typ: CIM_ConcreteJob

Ein optionaler Verweis auf ein Msvm_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]

Typ: datetime

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

Typ: uint32

Diese Methode gibt einen der folgenden Werte zurück.

Rückgabecode/-wert	BESCHREIBUNG
Abgeschlossen ohne Fehler 0	Erfolg.
Nicht unterstützt 1
Unbekannter/nicht angegebener Fehler 2
Kann NICHT innerhalb des Timeoutzeitraums abgeschlossen werden 3
Fehler 4
Ungültiger Parameter 5
In Verwendung 6
DMTF Reserviert ..
Methodenparameter überprüft – Übergang gestartet 4096
Ungültiger Zustandsübergang 4097
Verwendung des Timeoutparameters wird nicht unterstützt 4098
Beschäftigt 4099
Reservierte Methode 4100..32767
Herstellerspezifisch 32768..65535

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_GuestServiceInterfaceComponent

Freigeben über