CIM_IPProtocolEndpoint 類別的 RequestStateChange 方法
要求將專案的狀態變更為 RequestedState 參數中指定的值。 當要求的狀態變更發生時,元素的 EnabledState 和 RequestedState 會相同。 叫用 RequestChangeState 方法多次可能會導致先前的要求遭到覆寫或遺失。 如果傳回 0,則工作已順利完成,而且不需要使用 ConcreteJob。 如果傳回 4096 (0x1000),則工作需要一些時間才能完成,將建立 ConcreteJob,並在輸出參數 Job 中傳回其參考。 任何其他傳回碼都表示錯誤狀況。
語法
uint32 RequestStateChange(
[in] uint16 RequestedState,
[out] CIM_ConcreteJob Job,
[in] datetime TimeoutPeriod
);
參數
-
RequestedState [in]
-
針對專案要求的狀態。 如果 RequestStateChange 方法的傳回碼是 0 ('Completed with No Error')、3 ('Timeout'), 或 4096 (0x1000) ('Job Started') 的傳回碼,這項資訊將會放入 實例的 RequestedState 屬性中。 如需 RequestedState 值的詳細說明 ,請參閱 EnabledState 和 RequestedState 屬性的描述。
-
已開啟 (2)
-
已 停用 (3)
-
關機 (4)
-
離線 (6)
-
測試 (7)
-
延遲 (8)
-
靜止 (9)
-
重新啟動 (10)
-
重設 (11)
-
DMTF 保留 (12 32767)
-
廠商保留 (32768 65535)
-
-
作業 [out]
-
包含 作業參考的 CIM_ConcreteJob(如果工作已完成,可以是 null)。
-
TimeoutPeriod [in]
-
逾時期間,指定客戶端預期轉換至新狀態所花費的時間上限。 間隔格式必須用來指定此期間。 值為 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 |
|