Msvm_GuestServiceInterfaceComponent::RequestStateChange 方法

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

語法

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

參數

RequestedState [in]

類型: uint16

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

已啟用 (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