RequestStateChange-Methode der MSFT_StorageJob-Klasse
Fordert an, dass der Status des Auftrags in den im RequestedState-Parameter angegebenen Wert geändert wird.
Syntax
UInt32 RequestStateChange(
[in] UInt16 RequestedState,
[out] String ExtendedStatus
);
Parameter
RequestedState [in]
Der neue Zustand.
| Wert | Bedeutung |
|---|---|
| Start 2 | Dieser Wert ändert den Wert der JobState-Eigenschaft in Running. |
| Anhalten 3 | Dieser Wert beendet den Auftrag vorübergehend. Die Absicht besteht darin, den Auftrag anschließend mit einem zweiten Aufruf von RequestStateChange neu zu starten, wobei der RequestedState-Parameter auf Start festgelegt ist. Möglicherweise kann der Auftrag in den Dienstzustand wechseln, während er angehalten ist. (Dies ist auftragsspezifisch.) |
| Beenden 4 | Dieser Wert beendet den Auftrag sauber, speichert Daten, behält den Zustand bei und beendet alle zugrunde liegenden Prozesse in geordneter Weise. |
| Kill 5 | Dieser Wert beendet den Auftrag sofort, ohne dass Daten gespeichert oder der Zustand beibehalten werden muss. |
| Dienst 6 | Dieser Wert versetzt den Auftrag in einen anbieterspezifischen Dienstzustand. Möglicherweise ist es möglich, den Auftrag neu zu starten. |
| DMTF Reserviert 7...32767 | Werte zwischen 7 und 32767 (einschließlich) sind für DMTF reserviert. |
| Reservierter Anbieter 32768..65535 | Werte zwischen 32768 und 65535 (einschließlich) sind für Anbieter reserviert. |
ExtendedStatus [out]
Eine Zeichenfolge, die ein eingebettetes MSFT_StorageExtendedStatus -Objekt enthält.
Dieser Parameter ermöglicht es dem Speicheranbieter, erweiterte (implementierungsspezifische) Fehlerinformationen zurückzugeben.
Rückgabewert
Erfolg (0)
Nicht unterstützt (1)
Nicht angegebener Fehler (2)
Timeout (3)
Fehler (4)
Ungültiger Parameter (5)
Methodenparameter überprüft – Auftrag gestartet (4096)
Größe nicht unterstützt (4097)
Zugriff verweigert (40001)
Es sind nicht genügend Ressourcen vorhanden, um den Vorgang abzuschließen. (40002)
Es kann keine Verbindung mit dem Speicheranbieter hergestellt werden. (46000)
Der Speicheranbieter kann keine Verbindung mit dem Speichersubsystem herstellen. (46001)
Hinweise
Wenn Sie diese Methode mehrmals aufrufen, können frühere Anforderungen überschrieben werden oder verloren gehen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Namespace | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |