Msvm_ConcreteJob 類別的 RequestStateChange 方法
要求將作業的狀態變更為指定的狀態。 多次叫用 RequestStateChange 方法可能會導致先前的要求遭到覆寫或遺失。 如果傳回 0，則工作成功完成。 任何其他傳回碼都表示錯誤狀況。
語法
uint32 RequestStateChange(
[in] uint16 RequestedState,
[in] datetime TimeoutPeriod
);
參數
-
RequestedState [in]
-
類型： uint16
作業的新狀態。
-
開始 (2)
-
將狀態變更為「執行中」。
-
暫停 (3)
-
暫時停止作業。 目的是後續使用 「Start」 重新開機作業。 暫停時可能進入「服務」狀態。 (這是作業特定的。)
-
終止 (4)
-
以正常方式停止作業、儲存資料、保留狀態，以及依序關閉所有基礎進程。
-
kill (5)
-
立即終止作業，不需要儲存資料或保留狀態。
-
服務 (6)
-
將作業放入廠商特定的服務狀態。 可能會重新開機作業。
-
DMTF 保留
-
保留的。
-
廠商保留
-
保留的。
TimeoutPeriod [in]
類型： datetime
逾時期間，指定用戶端預期轉換至新狀態所花費的時間上限。 間隔格式必須用來指定逾時期間。 值為 0 或 Null 表示用戶端沒有轉換的時間需求。 如果這個屬性不包含 0 或 Null ，而且實作不支援此參數，則必須傳回傳回 4098 (使用不支援的逾時參數) 。
傳回值
類型： uint32
這個方法會傳回下列其中一個值。
-
已完成，沒有錯誤 (0)
-
不支援 (1)
-
未知/未指定的錯誤 (2)
-
無法在逾時期間內完成 (3)
-
失敗 (4)
-
不正確參數 (5)
-
在 [使用 (6)
-
DMTF 保留 (7 4095)
-
已檢查方法參數 - 轉換開始 (4096)
-
不正確狀態轉換 (4097)
-
不支援使用逾時參數 (4098)
-
忙碌 (4099)
-
保留 的方法 (4100 32767)
-
廠商特定 (32768 65535)
備註
UAC 篩選可能會限制 存取Msvm_ConcreteJob 類別。 如需詳細資訊，請參閱 使用者帳戶控制和 WMI。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows 8 [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows Server 2012 [僅限傳統型應用程式] |
| 命名空間 |
Root\Virtualization\V2 |
| MOF |
|
| DLL |
|