CIM_ConcreteJob 类的 RequestStateChange 方法

请求将作业的状态更改为 RequestedState 参数中指定的值。 多次调用 RequestStateChange 方法可能会导致早期请求被覆盖或丢失。

如果返回 0，则任务已成功完成。 任何其他返回代码指示错误条件。

语法

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

参数

RequestedState [in]

要请求作业的状态。 可能的值如下：

开始 (2)

将状态更改为“正在运行”。

暂停 (3)

暂时停止作业。 目的是随后使用“Start”重启作业。 暂停时可能进入“服务”状态。 (这是特定于作业的.)

终止 (4)

干净地停止作业、保存数据、保留状态，并有序地关闭所有基础进程。

杀死 (5)

立即终止作业，无需保存数据或保留状态。

服务 (6)

将作业置于特定于供应商的服务状态。 可以重启作业。

DMTF 保留 (7..32767)

供应商预留 (32768..65535)

TimeoutPeriod [in]

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

返回值

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

已完成，无错误 (0)

不支持 (1)

未知/未指定的错误 (2)

无法在超时期限内完成 (3)

失败 (4)

参数 (5) 无效

正在使用 (6)

DMTF 保留 (.)

方法参数已选中 - 转换启动 (4096)

状态转换 (4097) 无效

不支持使用超时参数 (4098)

忙碌 (4099)

方法保留 (4100..32767)

供应商特定 (32768..65535)

要求

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

另请参阅

CIM_ConcreteJob