CIM_EnabledLogicalElement 类的 RequestStateChange 方法

请求将元素的状态更改为 RequestedState 参数中指定的值。当请求的状态发生更改时，元素的 EnabledState 和 RequestedState 将相同。多次调用 RequestStateChange 方法可能会导致早期请求被覆盖或丢失。

语法

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

RequestedState [in]: 为元素请求的状态。如果 RequestStateChange 方法的返回代码为 0 (“已完成且无错误”) 或 4096 (0x1000) (“Job Started”) ，则此信息将放入实例的 RequestedState 属性中。有关 RequestedState 值的详细说明，请参阅 EnabledState 和 RequestedState 属性的说明。
开始 (2): 将状态更改为“正在运行”。
暂停 (3): 暂时停止作业。目的是随后使用“Start”重启作业。暂停时，可能会进入“服务”状态。 (这是特定于作业的。)
终止 (4): 干净地停止作业，保存数据，保留状态，并以有序的方式关闭所有基础进程。
杀死 (5): 立即终止作业，无需保存数据或保留状态。
服务 (6): 将作业置于特定于供应商的服务状态。可以重启作业。
DMTF 保留 (7..32767)
供应商预留 (32768..65535)

作业 [out]

可以包含对为跟踪由方法调用启动的状态转换而创建的 CIM_ConcreteJob 的引用。

TimeoutPeriod [in]

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

成功时返回 0;否则，将返回错误。

要求	值
最低受支持的客户端	Windows 8.1
最低受支持的服务器	Windows Server 2012 R2
命名空间	Root\virtualization\v2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe