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

此方法返回以下值之一。

返回代码/值 说明
已完成,无错误
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