RequestStateChange-Methode der Msvm _ ConcreteJob-Klasse
Fordert an, dass der Status des Auftrags in den angegebenen Zustand geändert wird. Das mehrfache Aufrufen der RequestStateChange-Methode kann dazu führen, dass frühere Anforderungen überschrieben oder verloren gehen. Wenn 0 zurückgegeben wird, wurde die Aufgabe erfolgreich abgeschlossen. Jeder andere Rückgabecode gibt einen Fehlerzustand an.
Syntax
uint32 RequestStateChange(
[in] uint16 RequestedState,
[in] datetime TimeoutPeriod
);
Parameter
-
RequestedState [ In]
-
Typ: uint16
Der neue Zustand eines Auftrags.
-
Start (2)
-
Ändert den Status in "Wird ausgeführt".
-
Suspend (3)
-
Beendet den Auftrag vorübergehend. Anschließend soll der Auftrag mit "Start" neu gestartet werden. Es kann möglich sein, den Status "Dienst" zu erhalten, während er angehalten wird. (Dies ist auftragsspezifisch.)
-
Terminate (4)
-
Beendet den Auftrag sauber, wobei Daten gespeichert, der Zustand beibehalten und alle zugrunde liegenden Prozesse in einer geordneten Weise heruntergefahren werden.
-
Kill (5)
-
Beendet den Auftrag sofort, ohne dass Daten gespeichert oder der Zustand beibehalten werden muss.
-
Dienst (6)
-
Versetzt den Auftrag in einen anbieterspezifischen Dienststatus. Möglicherweise ist es möglich, den Auftrag neu zu starten.
-
DMTF Reserved
-
Reserviert.
-
Reservierter Anbieter
-
Reserviert.
TimeoutPeriod [ In]
Typ: datetime
Ein Timeoutzeitraum, der die maximale Zeitspanne angibt, die der Client für den Übergang in den neuen Zustand erwartet. Das Intervallformat muss verwendet werden, um den Timeoutzeitraum anzugeben. Der Wert 0 oder NULL 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 der Rückgabecode 4098 (Use Of Timeout Parameter Not Supported) zurückgegeben werden.
Rückgabewert
Typ: uint32
Diese Methode gibt einen der folgenden Werte zurück.
-
Abgeschlossen ohne Fehler (0)
-
Nicht unterstützt (1)
-
Unbekannter/nicht angegebener Fehler (2)
-
Innerhalb des Timeoutzeitraums (3) kann nicht abgeschlossen werden.
-
Fehler (4)
-
Ungültiger Parameter (5)
-
Wird verwendet (6)
-
DMTF Reserved (7 4095)
-
Überprüfte Methodenparameter – Übergang gestartet (4096)
-
Ungültiger Zustandsübergang (4097)
-
Verwendung des Timeoutparameters nicht unterstützt (4098)
-
Ausgelastet (4099)
-
Reservierte Methode (4100 32767)
-
Herstellerspezifisch (32768 65535)
Hinweise
Der Zugriff auf die Msvm _ ConcreteJob-Klasse kann durch UAC-Filterung eingeschränkt werden. Weitere Informationen finden Sie unter Benutzerkontensteuerung und WMI.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
[Windows 8 Nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
[Windows Server 2012 Nur Desktop-Apps] |
| Namespace |
Root \ Virtualization \ V2 |
| MOF |
|
| DLL |
|