Msvm _ GuestService::RequestStateChange-Methode

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 die RequestedState-Eigenschaft der -Instanz 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)

Stille (9)

Neustart (10)

Zurücksetzen (11)

DMTF Reserved (..)

Reservierter Anbieter (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 abzurufen.

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 (Use Of Timeout Parameter Not Supported) 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 Zustand 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 Nur [ R2-Desktop-Apps]
Namespace
\\Root \ Virtualization \ V2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

Siehe auch

Msvm _ GuestService