要求變更專案的狀態。
語法
uint32 RequestStateChange(
[in] uint16 RequestedState,
[out] CIM_ConcreteJob REF Job,
[in] datetime TimeoutPeriod
);
參數
-
RequestedState [in]
-
針對 專案要求的新狀態。 如果傳回碼為 0 ('Completed 且沒有錯誤') 、3 ('Timeout') 或 4096 (0x1000) ('Job Started') ，則此資訊會放入 實例的 RequestedState 屬性中。 如需 RequestedState 值的詳細說明，請參閱 EnabledState 和 RequestedState 屬性的描述。
-
已啟用 (2)
-
停用 (3)
-
關閉 (4)
-
離線 (6)
-
測試 (7)
-
延遲 (8)
-
靜止 (9)
-
重新開機 (10)
-
重設 (11)
-
DMTF 保留 (。。)
-
廠商保留 (32768..65535)
作業 [out]
作業的參考。 如果工作已完成，這個參數可以是 Null 。
TimeoutPeriod [in]
用戶端預期轉換至新狀態所花費的時間上限。 間隔格式必須用來指定這個逾時期間。 值為 0 或 Null 表示用戶端沒有轉換的時間需求。 如果這個屬性不包含 0 或 Null，而且實作不支援此參數，則會傳回的傳回碼為 4098 (「使用逾時參數不支援」) 。
傳回值
-
已完成，沒有錯誤 (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 |
|