CIM_ConcreteJob WMI 類別的 RequestStateChange 方法
要求將作業的狀態變更為指定的值。 允許的轉換是作業特定和廠商特定的。 若要叫用此方法多次,可能會導致先前的要求遭到覆寫或遺失。
語法
uint32 RequestStateChange(
[in] uint16 RequestedState,
[in] datetime TimeoutPeriod
);
參數
-
RequestedState [in]
-
指定應該變更作業的狀態。
值 意義 - 啟動
- 2
將狀態變更為 [執行中]。 - 暫止
- 3
暫時停止作業。 您可以重新啟動作業,而且可能在作業暫停時進入服務狀態。 這個值是作業特定的。 - 終止
- 4
以有序的方式停止作業、儲存數據、保留狀態,以及關閉所有基礎進程。 - 殺
- 5
立即停止作業,不需要儲存資料或保留狀態。 - 服務
- 6
將作業放入廠商特定的服務狀態。 可能會從這個狀態重新啟動作業。 - DMTF 保留
- 7 32767
已保留。 - 廠商保留
- 32768 65535
已保留。 -
TimeoutPeriod [in]
-
指定客戶端預期轉換至新狀態所花費的時間上限。 間隔格式必須用來指定 TimeoutPeriod 參數。 值為 0 或 null 參數,表示客戶端沒有轉換的時間需求。
注意
如果實作不支援此參數,而且這個屬性不包含 0 或 null, 則必須傳回使用逾時參數不支援 的值。
傳回值
這個方法會傳回下列其中一個值。
-
已完成且沒有錯誤 (0)
-
不支援 (1)
-
未知/未指定的錯誤 (2)
-
無法在逾時期間 內完成 (3)
-
失敗 (4)
-
不合法的參數 (5)
-
使用 中 (6)
-
DMTF 保留 (7 4095)
-
檢查方法參數 - 轉換已 啟動 (4096)
-
無效的狀態轉換 (4097)
-
不支援 使用逾時參數 (4098)
-
忙碌 (4099)
-
保留 方法 (4100 32767)
-
廠商特定 (32768 65535)
需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows 8 |
最低支援的伺服器 |
Windows Server 2012 |
Namespace |
Root\standardcimv2 |
MOF |
|
DLL |
|