Msvm_GuestService：：RequestStateChange 方法
要求將客體服務的狀態變更為指定的值。
語法
uint32 RequestStateChange(
[in] uint16 RequestedState,
[out] CIM_ConcreteJob Job,
[in] datetime TimeoutPeriod
);
參數
-
RequestedState [in]
-
新狀態。 如果RequestStateChange方法的傳回碼為 0 或 4096，則資訊會放在 實例的RequestedState屬性中。 如需詳細資訊，請參閱元素的 EnabledState 和 RequestedState 屬性描述。 這必須是下列其中一個值。
-
已啟用 (2)
-
停用 (3)
-
關閉 (4)
-
離線 (6)
-
測試 (7)
-
延遲 (8)
-
靜止 (9)
-
重新開機 (10)
-
重設 (11)
-
DMTF 保留 (。。)
-
廠商保留 (32768..65535)
作業 [out]
如果以非同步方式執行作業，則會傳回 CIM_ConcreteJob 物件的選擇性參考。 如果有的話，傳回的參考可用來監視進度，並取得 方法的結果。
TimeoutPeriod [in]
逾時期間，指定用戶端預期轉換至新狀態所花費的時間上限。 間隔格式必須用來指定逾時期間。 值為 0 或 Null 表示用戶端沒有轉換的時間需求。 如果此屬性不包含 0 或 Null ，且實作不支援此參數，則必須傳回傳回碼 4098 (使用逾時參數 不支援) 。
傳回值
這個方法會傳回下列其中一個值。
| 傳回碼/值 | Description |
|---|---|
|
成功。 |
|
|
|
轉換是非同步。 |
|
|
|
拒絕存取。 |
|
不支援 RequestedState 參數中指定的值。 |
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows 8.1 [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows Server 2012 R2 [僅限傳統型應用程式] |
| 命名空間 |
\\Root\Virtualization\V2 |
| MOF |
|
| DLL |
|