CIM_EnabledLogicalElement 類別的 RequestStateChange 方法
要求將專案的狀態變更為 RequestedState 參數中指定的值。 當要求的狀態變更發生時，元素的 EnabledState 和 RequestedState 會相同。 叫用 RequestStateChange 方法多次可能會導致先前的要求遭到覆寫或遺失。
語法
uint32 RequestStateChange(
[in] uint16 RequestedState,
[out] CIM_ConcreteJob REF Job,
[in] datetime TimeoutPeriod
);
參數
-
RequestedState [in]
-
針對 專案要求的狀態。 如果RequestStateChange方法的傳回碼為 0 ('Completed with No Error') ，或 4096 (0x1000) ('Job Started') ，這項資訊將會放在 實例的RequestedState屬性中。 如需RequestedState值的詳細說明，請參閱EnabledState和RequestedState屬性的描述。
-
開始 (2)
-
將狀態變更為 「正在執行」。
-
暫停 (3)
-
暫時停止作業。 其意圖是後續使用 'Start' 重新開機作業。 暫停時可能進入「服務」狀態。 (這是作業特定的。)
-
終止 (4)
-
完全停止作業、儲存資料、保留狀態，並依序關閉所有基礎進程。
-
Kill (5)
-
立即終止作業，不需要儲存資料或保留狀態。
-
服務 (6)
-
將作業放入廠商特定的服務狀態。 可能會重新開機作業。
-
DMTF 保留 (7..32767)
-
廠商保留 (32768..65535)
作業 [out]
可能包含所建立 CIM_ConcreteJob 的參考，以追蹤方法調用所起始的狀態轉換。
TimeoutPeriod [in]
逾時期間，指定用戶端預期轉換至新狀態所花費的時間上限。 間隔格式必須用來指定逾時期間。 值為 0 或 Null 表示用戶端沒有轉換的時間需求。 如果這個屬性不包含 0 或 Null ，而且實作不支援此參數，則必須傳回傳回 4098 (使用逾時 參數 不支援) 。
傳回值
在成功時傳回 0;否則，傳回錯誤。
-
已完成 ， (0)
-
不支援 (1)
-
未知或未指定的錯誤 (2)
-
在逾時期間 (3) 內無法完成
-
失敗 (4)
-
不正確參數 (5)
-
在 [使用 (6)
-
DMTF 保留 (。。)
-
已檢查方法參數 - 作業啟動 (4096)
-
不正確狀態轉換 (4097)
-
不支援使用 Timeout 參數 (4098)
-
忙碌 (4099)
-
保留 (4100..32767)
-
廠商特定 (32768..65535)
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows 8.1 |
| 最低支援的伺服器 |
Windows Server 2012 R2 |
| 命名空間 |
Root\virtualization\v2 |
| MOF |
|
| DLL |
|