Methode RequestStateChange der WMI-Klasse CIM_ConcreteJob
Fordert die Änderung des Status des Jobs auf den angegebenen Wert an. Die zulässigen Übergänge sind auftragsspezifisch und anbieterspezifisch. Wenn diese Methode mehrmals aufgerufen wird, können frühere Anforderungen überschrieben werden oder verlorengehen.
Syntax
uint32 RequestStateChange(
[in] uint16 RequestedState,
[in] datetime TimeoutPeriod
);
Parameter
-
RequestedState [in]
-
Gibt den Status an, in den der Job geändert werden soll.
Werte Bedeutung - Starten
- 2
Ändert den Status in „Wird ausgeführt“. - Angehalten
- 3
Beendet den Job vorübergehend. Sie können den Job neu starten und möglicherweise in den Servicestatus gehen, während der Job angehalten ist. Dieser Wert ist auftragsspezifisch. - Terminate
- 4
Der Job wird ordentlich gestoppt, Daten werden gespeichert, der Status wird beibehalten und alle zugrunde liegenden Prozesse werden geordnet heruntergefahren. - Kill
- 5
Beendet den Job sofort ohne Anforderung, Daten zu speichern oder den Status beizubehalten. - Dienst
- 6
Versetzt den Job in einen anbieterspezifischen Servicestatus. Der Job kann möglicherweise aus diesem Status heraus neu gestartet werden. - Von DMTF reserviert
- 7 32767
Reserviert. - Von Anbieter reserviert
- 32768 65535
Reserviert. -
TimeoutPeriod [in]
-
Gibt die maximale Zeitdauer an, die der Client für den Übergang zum neuen Status erwartet. Zum Angeben des Parameters TimeoutPeriod-Parameter 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.
Hinweis
Wenn die Implementierung diesen Parameter nicht unterstützt und diese Eigenschaft nicht 0 oder NULL enthält, muss der Wert Verwendung des Timeoutparameters nicht unterstützt zurückgegeben werden.
Rückgabewert
Diese Methode gibt einen der folgenden Werte zurück.
-
Ohne Fehler abgeschlossen (0)
-
Nicht unterstützt (1)
-
Unbekannter/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 – Übergang 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 |
|