RequestStateChange-Methode der MSFT_NetIPv4Protocol-Klasse
Fordert die Änderung des Status des Elements auf den im Parameter RequestedState angegebenen Wert an. Wenn die angeforderte Statussänderung stattfindet, sind der EnabledState und der RequestedState des Elements identisch. 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 Job,
[in] datetime TimeoutPeriod
);
Parameter
-
RequestedState [in]
-
Der für das Element angeforderte Status. 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“) lautet. In der Beschreibung der EnabledState- und RequestedState-Eigenschaften finden Sie ausführliche Erläuterungen der RequestedState-Werte.
-
Aktiviert (2)
-
Deaktiviert (3)
-
Herunterfahren (4)
-
Offline (6)
-
Test (7)
-
Abgrenzen (8)
-
Stilllegen (9)
-
Neu starten (10)
-
Zurücksetzen (11)
-
Für DMTF reserviert (12 32767)
-
Für 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 zeigt an, dass der Client keine zeitlichen Anforderungen 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)
-
Für DMTF reserviert (7 4095)
-
Methodenparameter überprüft – Job gestartet (4096)
-
Ungültiger Statusübergang (4097)
-
Verwendung des Timeoutparameters nicht unterstützt (4098)
-
Ausgelastet (4099)
-
Methode reserviert (4100 32767)
-
Anbieterspezifisch (32768 65535)
Anforderungen
| Unterstützte Mindestversion (Client) |
Windows 8 |
| Unterstützte Mindestversion (Server) |
Windows Server 2012 |
| Namespace |
Root\standardcimv2 |
| MOF |
|
| DLL |
|