Msvm_GuestService::RequestStateChange 方法

请求将来宾服务的状态更改为指定的值。

语法

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

参数

RequestedState [in]

新状态。 如果 RequestStateChange 方法的返回代码为 0 或 4096,则信息将放置在 实例的 RequestedState 属性中。 有关详细信息,请参阅 元素的 EnabledStateRequestedState 属性的说明。 这必须是以下值之一。

已启用 (2)

已禁用 (3)

关闭 (4)

脱机 (6)

测试 (7)

延迟 (8)

静止 (9)

重新启动 (10)

重置 (11)

DMTF 保留 (.)

供应商预留 (32768..65535)

作业 [out]

CIM_ConcreteJob 对象的可选引用,如果异步执行操作,则返回该对象。 如果存在,则返回的引用可用于监视进度并获取方法的结果。

TimeoutPeriod [in]

一个超时期限,指定客户端预期转换到新状态所花费的最长时间。 必须使用间隔格式指定超时期限。 值为 0 或 Null 表示客户端没有转换时间要求。 如果此属性不包含 0 或 Null ,并且实现不支持此参数,则必须返回返回 4098 (使用不支持的超时参数) 。

返回值

此方法返回以下值之一。

返回代码/值 说明
已完成,无错误
0
成功。
不支持
1
已选中方法参数 - 转换已启动
4096
转换是异步的。
不支持使用 Timeout 参数
4098
拒绝访问
32769
访问被拒绝。
此操作的状态无效
32775
不支持 RequestedState 参数中指定的值。

要求

要求
最低受支持的客户端
Windows 8.1 [仅限桌面应用]
最低受支持的服务器
Windows Server 2012 R2 [仅限桌面应用]
命名空间
\\Root\Virtualization\V2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

另请参阅

Msvm_GuestService