共用方式為


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
NetTCPIP.mof
DLL
NetTCPIP.dll

另請參閱

CIM_IPProtocolEndpoint