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 |
|---|---|
|
Erfolg. |
|
|
|
Der Übergang erfolgt asynchron. |
|
|
|
Zugriff verweigert: |
|
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 |
|
| DLL |
|