Methode RequestStateChange der WMI-Klasse CIM_EnabledLogicalElement
Fordert die Änderung des Status des Elements auf den im Parameter RequestedState angegebenen Wert an. Wenn die angeforderte Statusänderung erfolgt, stimmen EnabledState und RequestedState des Elements miteinander überein. Wenn die Methode RequestChangeState mehrmals aufgerufen wird, können frühere Anforderungen überschrieben werden oder verloren gehen. Wenn 0 zurückgegeben wird, wurde die Aufgabe erfolgreich abgeschlossen und ConcreteJob war nicht erforderlich. Wenn 4096 (0x1000) zurückgegeben wird, dauert die Ausführung der Aufgabe einige Zeit, ConcreteJob wird erstellt, und der entsprechende Verweis wird im Ausgabeparameter Job zurückgegeben. Jeder andere Rückgabecode weist auf eine Fehlerbedingung hin.
Syntax
uint32 RequestStateChange(
[in] uint16 RequestedState,
[out] CIM_ConcreteJob REF Job,
[in] datetime TimeoutPeriod
);
Parameter
-
RequestedState [in]
-
Der angeforderte Status für das Element. Diese Informationen werden in der Eigenschaft RequestedState der Instanz untergebracht, wenn der Rückgabecode der Methode RequestStateChange 0 („Abgeschlossen ohne Fehler“), 3 („Timeout“) oder 4096 (0x1000) („Job gestartet“) ist. In der Beschreibung der Eigenschaften EnabledState und RequestedState finden Sie ausführliche Erläuterungen der RequestedState-Werte.
-
Aktiviert (2)
-
Deaktiviert (3)
-
Herunterfahren (4)
-
Offline (6)
-
Testen (7)
-
Zurückstellen (8)
-
Stilllegen (9)
-
Neu starten (10)
-
Zurücksetzen (11)
-
Von DMTF reserviert (12 32767)
-
Von Anbieter reserviert (32768 65535)
-
-
Job [out]
-
Ein CIM_ConcreteJob mit einem Verweis auf den Job (kann null sein, wenn die Aufgabe abgeschlossen ist).
-
TimeoutPeriod [in]
-
Ein Timeoutzeitraum, der die maximale Zeitdauer angibt, die der Client für den Übergang zum neuen Status erwartet. Zum Angeben dieses Zeitraums muss das Intervallformat verwendet werden. Ein Wert von 0 oder ein NULL-Parameter 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 ein Rückgabecode von „Verwendung des Timeoutparameters nicht unterstützt“ zurückgegeben werden.
Rückgabewert
-
Ohne Fehler abgeschlossen (0)
-
Nicht unterstützt (1)
-
Unbekannter oder unspezifischer Fehler (2)
-
Kann innerhalb des Timeoutzeitraums nicht abgeschlossen werden (3)
-
Fehler (4)
-
Ungültiger Parameter (5)
-
In Gebrauch (6)
-
Von DMTF reserviert (7 4095)
-
Methodenparameter überprüft – Job gestartet (4096)
-
Ungültiger Statusübergang (4097)
-
Verwendung des Timeoutparameters nicht unterstützt (4098)
-
Ausgelastet (4099)
-
Von Methode reserviert (4100 32767)
-
Anbieterspezifisch (32768 65535)
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 8 |
| Unterstützte Mindestversion (Server) |
Windows Server 2012 |
| Namespace |
Root\standardcimv2 |
| MOF |
|
| DLL |
|