共用方式為


Msvm_GuestServiceInterfaceComponent::RequestStateChange 方法

要求客體服務介面元件的狀態變更為指定的值。

語法

uint32 RequestStateChange(
  [in]  uint16              RequestedState,
  [out] CIM_ConcreteJob Job,
  [in]  datetime            TimeoutPeriod
);

參數

RequestedState [in]

類型: uint16

新狀態。 如果RequestStateChange方法的傳回碼為 0 或 4096,則資訊會放在 實例的RequestedState屬性中。 如需詳細資訊,請參閱 元素的 EnabledStateRequestedState 屬性的描述。 這必須是下列其中一個值。

已啟用 (2)

已停用 (3)

關閉 (4)

離線 (6)

測試 (7)

延遲 (8)

停止 (9)

重新開機 (10)

重設 (11)

DMTF 保留 (。。)

廠商保留 (32768..65535)

作業 [out]

類型: CIM_ConcreteJob

如果以非同步方式執行作業, 則為傳回之Msvm_ConcreteJob 物件的選擇性參考。 如果存在,則傳回的參考可用來監視進度,並取得 方法的結果。

TimeoutPeriod [in]

類型: datetime

逾時期間,指定用戶端預期轉換至新狀態所花費的時間上限。 間隔格式必須用來指定逾時期間。 值為 0 或 Null 表示用戶端沒有轉換的時間需求。 如果這個屬性不包含 0 或 Null ,而且實作不支援此參數,則必須傳回傳回 4098 (使用逾時 參數 不支援) 。

傳回值

類型: uint32

這個方法會傳回下列其中一個值。

傳回碼/值 Description
已完成,沒有錯誤
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
WindowsVirtualization.V2.mof
DLL
Vmms.exe

另請參閱

Msvm_GuestServiceInterfaceComponent