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
WindowsVirtualization.V2.mof
DLL
Vmms.exe

Siehe auch

Msvm _ ConcreteJob