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 |
|
| DLL |
|