Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 eine Fehlerbedingung an.
Syntax
uint32 RequestStateChange(
[in] uint16 RequestedState,
[in] datetime TimeoutPeriod
);
Parameter
-
RequestedState [in]
-
Typ: uint16
Der neue Status eines Auftrags.
-
Start (2)
-
Ändert den Status in "Wird ausgeführt".
-
Anhalten (3)
-
Beendet den Auftrag vorübergehend. Der Auftrag soll anschließend mit "Start" neu gestartet werden. Es ist möglicherweise möglich, den Status "Dienst" zu eingeben, während angehalten. (Dies ist auftragsspezifisch.)
-
Beenden (4)
-
Beendet den Auftrag sauber, speichert Daten, behält den Zustand bei und fährt alle zugrunde liegenden Prozesse ordnungsgemäß herunter.
-
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 Reserviert
-
Reserviert.
-
Anbieter reserviert
-
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 (Verwendung des Timeoutparameters nicht unterstützt) 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 kann nicht abgeschlossen werden (3)
-
Fehler (4)
-
Ungültiger Parameter (5)
-
In Verwendung (6)
-
DMTF Reserviert (7 4095)
-
Methodenparameter überprüft – Übergang gestartet (4096)
-
Ungültiger Zustandsübergang (4097)
-
Verwendung des Timeoutparameters wird nicht unterstützt (4098)
-
Busy (4099)
-
Reservierte Methode (4100 32767)
-
Anbieterspezifisch (32768 65535)
Bemerkungen
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 |
|