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 (使用不支持的超时参数) 。
返回值
此方法返回以下值之一。
返回代码/值 | 说明 |
---|---|
|
成功。 |
|
|
|
转换是异步的。 |
|
|
|
访问被拒绝。 |
|
不支持 RequestedState 参数中指定的值。 |
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows 8.1 [仅限桌面应用] |
最低受支持的服务器 |
Windows Server 2012 R2 [仅限桌面应用] |
命名空间 |
\\Root\Virtualization\V2 |
MOF |
|
DLL |
|