RequestStateChange-Methode der CIM_EnabledLogicalElement-Klasse

Fordert an, dass der Zustand des Elements in den wert geändert wird, der im RequestedState-Parameter angegeben ist. Wenn die angeforderte Zustandsänderung erfolgt, sind EnabledState und RequestedState des Elements identisch. Das mehrfache Aufrufen der RequestStateChange-Methode kann dazu führen, dass frühere Anforderungen überschrieben oder verloren gehen.

Syntax

uint32 RequestStateChange(
  [in]  uint16              RequestedState,
  [out] CIM_ConcreteJob REF Job,
  [in]  datetime            TimeoutPeriod
);

Parameter

RequestedState [in]

Der für das -Element angeforderte Zustand. Diese Informationen werden in die RequestedState-Eigenschaft des instance eingefügt, wenn der Rückgabecode der RequestStateChange-Methode 0 ("Mit keinem Fehler abgeschlossen") oder 4096 (0x1000) ('Auftrag gestartet') ist. Ausführliche Erläuterungen zu den RequestedState-Werten finden Sie in der Beschreibung der Eigenschaften EnabledState und RequestedState.

Start (2)

Ändert den Status in "Running".

Anhalten (3)

Beendet den Auftrag vorübergehend. Die Absicht besteht darin, den Auftrag anschließend mit "Start" neu zu starten. Es kann möglich sein, den Status "Dienst" zu eingeben, während er angehalten wird. (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. Es kann möglich sein, den Auftrag neu zu starten.

DMTF Reserviert (7..32767)

Anbieter reserviert (32768..65535)

Auftrag [out]

Kann einen Verweis auf die CIM_ConcreteJob enthalten, die erstellt wurde, um den Zustandsübergang nachzuverfolgen, der durch den Methodenaufruf initiiert wurde.

TimeoutPeriod [in]

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 ein Rückgabecode von 4098 (Verwendung von Timeoutparameter nicht unterstützt) zurückgegeben werden.

Rückgabewert

Gibt bei Erfolg eine 0 zurück. Gibt andernfalls einen Fehler zurück.

Ohne Fehler abgeschlossen (0)

Nicht unterstützt (1)

Unbekannter oder nicht angegebener Fehler (2)

Kann innerhalb des Timeoutzeitraums nicht abgeschlossen werden (3)

Fehler (4)

Ungültiger Parameter (5)

In Verwendung (6)

DMTF Reserviert (..)

Methodenparameter überprüft – Auftrag gestartet (4096)

Ungültiger Zustandsübergang (4097)

Verwendung des Timeoutparameters wird nicht unterstützt (4098)

Busy (4099)

Methode Reserviert (4100..32767)

Herstellerspezifisch (32768..65535)

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8.1
Unterstützte Mindestversion (Server)	Windows Server 2012 R2
Namespace	Root\virtualization\v2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

Weitere Informationen

CIM_EnabledLogicalElement