RequestStateChange-Methode der CIM_ConcreteJob WMI-Klasse
Fordert an, dass der Status des Auftrags in den angegebenen Wert geändert wird. Die zulässigen Übergänge sind auftragsspezifisch und anbieterspezifisch. Wenn Sie diese Methode mehrmals aufrufen möchten, können frühere Anforderungen überschrieben oder verloren gehen.
Syntax
uint32 RequestStateChange(
[in] uint16 RequestedState,
[in] datetime TimeoutPeriod
);
Parameter
-
RequestedState [in]
-
Gibt den Zustand an, in den der Auftrag geändert werden soll.
Werte Bedeutung - starten
- 2
Ändert den Zustand in "Ausführen". - anhalten
- 3
Beendet den Auftrag vorübergehend. Sie können den Auftrag neu starten und möglicherweise den Dienststatus eingeben, während der Auftrag angehalten wird. Dieser Wert ist auftragsspezifisch. - beenden
- 4
Beendet den Auftrag sauber, speichert Daten, behält den Zustand bei und beendet alle zugrunde liegenden Prozesse auf geordnete Weise. - Kill
- 5
Beendet den Auftrag sofort ohne Anforderung, Daten zu speichern oder den Zustand beizubehalten. - Service-
- 6
Versetzt den Auftrag in einen anbieterspezifischen Dienststatus. Möglicherweise kann der Auftrag aus diesem Zustand neu gestartet werden. - reservierte DMTF-
- 7 32767
Reserviert. - reservierte
- 32768 65535
Reserviert. -
TimeoutPeriod [in]
-
Gibt die maximale Zeitspanne an, die der Client vom Übergang zum neuen Zustand erwartet. Das Intervallformat muss verwendet werden, um den TimeoutPeriod Parameter anzugeben. Ein Wert von 0 oder ein NULL-Parameter gibt an, dass der Client keine Zeitanforderungen für den Übergang hat.
Anmerkung
Wenn die Implementierung diesen Parameter nicht unterstützt und diese Eigenschaft nicht 0 oder NULL enthält, muss der wert Use Of Timeout Parameter Not Supported value zurückgegeben werden.
Rückgabewert
Diese Methode gibt einen der folgenden Werte zurück.
-
ohne Fehler abgeschlossen (0)
-
nicht unterstützt (1)
-
Unbekannter/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 - Übergang 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
| Anforderung | Wert |
|---|---|
| Mindestens unterstützter Client |
Windows 8 |
| Mindestens unterstützter Server |
Windows Server 2012 |
| Namespace |
Root\standardcimv2 |
| MOF |
|
| DLL |
|