Msvm_CopyFileToGuestJob::RequestStateChange-Methode

Artikel
06/13/2023

Ändert den Status des Auftrags.

Syntax

uint32 RequestStateChange(
  [in] uint16   RequestedState,
  [in] datetime TimeoutPeriod
);

Parameter

RequestedState [in]: Der neue Zustand. Dies sind die möglichen Werte:
Start (2): Ändert den Status in "Wird ausgeführt".
Anhalten (3): Beendet den Auftrag vorübergehend. Der Client kann den Auftrag anschließend mit "Start" neu starten. Der Client kann möglicherweise den Status "Dienst" eingeben, während er angehalten ist (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. Der Client kann den Auftrag möglicherweise neu starten.
DMTF Reserviert (7...32767)
Anbieter reserviert (32768..65535)

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 der Rückgabecode 4098 (Verwendung des Timeoutparameters nicht unterstützt) zurückgegeben werden.

Rückgabewert

Diese Methode gibt einen der folgenden Werte zurück.

Rückgabecode/-wert	BESCHREIBUNG
Abgeschlossen ohne Fehler 0	Erfolg.
Verwendung des Timeoutparameters wird nicht unterstützt 4098
Fehler 32768
Zugriff verweigert 32769	Zugriff verweigert.
Nicht unterstützt 32770
Der Status ist unbekannt. 32771
Timeout 32772
Ungültiger Parameter 32773
Das System wird verwendet. 32774
Ungültiger Status für diesen Vorgang 32775	Der im RequestedState-Parameter angegebene Wert wird nicht unterstützt.
Falscher Datentyp 32776
Das System ist nicht verfügbar. 32777
Nicht genügend Arbeitsspeicher 32778

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8.1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 R2 [nur Desktop-Apps]
Namespace	\\Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

Siehe auch

Msvm_CopyFileToGuestJob

Freigeben über