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