RequestStateChange-Methode der klasse MSFT_NetBaseIPProtocol
Fordert an, dass der Status des Elements in den im parameter RequestedState angegebenen Wert geändert wird. Wenn die angeforderte Statusänderung stattfindet, ist "EnabledState" und "RequestedState" des Elements identisch. Das Aufrufen der RequestChangeState Methode kann dazu führen, dass frühere Anforderungen überschrieben oder verloren gehen. Wenn 0 zurückgegeben wird, wurde die Aufgabe erfolgreich abgeschlossen, und die Verwendung von ConcreteJob war nicht erforderlich. Wenn 4096 (0x1000) zurückgegeben wird, dauert die Aufgabe einige Zeit, bis der Vorgang abgeschlossen ist, wird ConcreteJob erstellt und sein Verweis im Ausgabeparameter Job zurückgegeben. Jeder andere Rückgabecode gibt eine Fehlerbedingung an.
Syntax
uint32 RequestStateChange(
[in] uint16 RequestedState,
[out] CIM_ConcreteJob Job,
[in] datetime TimeoutPeriod
);
Parameter
-
RequestedState [in]
-
Der für das Element angeforderte Zustand. Diese Informationen werden in die RequestedState-Eigenschaft der Instanz eingefügt, wenn der Rückgabecode der RequestStateChange-Methode 0 ('Abgeschlossen ohne Fehler'), 3 ('Timeout') oder 4096 (0x1000) ('Auftrag gestartet') ist. In der Beschreibung der Eigenschaften "EnabledState" und "RequestedState" finden Sie ausführliche Erläuterungen der werte RequestedState.
-
Aktivierte (2)
-
Deaktiviert (3)
-
herunterfahren (4)
-
Offline- (6)
-
Test- (7)
-
zurückstellen (8)
-
Stilllegen (9)
-
Neustart (10)
-
zurücksetzen (11)
-
DMTF Reservierte (12 32767)
-
Anbieter reservierte (32768 65535)
-
-
Auftrag [out]
-
Eine CIM_ConcreteJob, die einen Verweis auf den Auftrag enthält (kann null sein, wenn die Aufgabe abgeschlossen ist).
-
TimeoutPeriod [in]
-
Ein Timeoutzeitraum, der die maximale Zeitspanne angibt, die der Client vom Übergang zum neuen Zustand erwartet. Das Intervallformat muss zum Angeben dieses Zeitraums 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 "Use Of Timeout Parameter Not Supported" zurückgegeben werden.
Rückgabewert
-
ohne Fehler abgeschlossen (0)
-
nicht unterstützt (1)
-
Unbekannter oder nicht angegebener Fehler (2)
-
Kann nicht innerhalb des Timeoutzeitraums (3) abgeschlossen werden.
-
Fehlgeschlagene (4)
-
Ungültiger Parameter (5)
-
In Verwendung (6)
-
RESERVIERTe DMTF- (7 4095)
-
Methodenparameter überprüft - Auftrag gestartet (4096)
-
Ungültiger Zustandsübergang (4097)
-
Verwendung des Timeoutparameters nicht unterstützt (4098)
-
Beschäftigt- (4099)
-
Methode Reserved (4100 32767)
-
Anbieterspezifische (32768 65535)
Anforderungen
| Mindestens unterstützter Client |
Windows 8 |
| Mindestens unterstützter Server |
Windows Server 2012 |
| Namespace |
Root\standardcimv2 |
| MOF |
|
| DLL |
|