Msvm_ConcreteJob 类的 RequestStateChange 方法
请求将作业的状态更改为指定状态。 多次调用 RequestStateChange 方法可能会导致早期请求被覆盖或丢失。 如果返回 0,则任务已成功完成。 任何其他返回代码指示错误条件。
语法
uint32 RequestStateChange(
[in] uint16 RequestedState,
[in] datetime TimeoutPeriod
);
参数
-
RequestedState [in]
-
类型: uint16
作业的新状态。
-
开始 (2)
-
将状态更改为“正在运行”。
-
暂停 (3)
-
暂时停止作业。 目的是随后使用“Start”重启作业。 暂停时,可能会进入“服务”状态。 (这是特定于作业的。)
-
终止 (4)
-
干净地停止作业、保存数据、保留状态以及有序地关闭所有基础进程。
-
杀死 (5)
-
立即终止作业,无需保存数据或保留状态。
-
服务 (6)
-
将作业置于特定于供应商的服务状态。 可以重启作业。
-
DMTF 保留
-
保留。
-
保留的供应商
-
保留。
TimeoutPeriod [in]
类型: datetime
一个超时期限,指定客户端预期转换到新状态所花费的最长时间。 必须使用间隔格式指定超时期限。 值为 0 或 Null 表示客户端没有转换时间要求。 如果此属性不包含 0 或 Null ,并且实现不支持此参数,则必须返回返回代码 4098 (使用不支持的超时参数) 。
返回值
类型: uint32
此方法返回以下值之一。
-
已完成,无错误 (0)
-
不支持 (1)
-
未知/未指定的错误 (2)
-
在 3) 的超时期限内无法完成 (
-
失败 (4)
-
参数 (5) 无效
-
正在使用 (6)
-
DMTF 保留 (7 4095)
-
方法参数已选中 - 转换启动 (4096)
-
状态转换 (4097) 无效
-
不支持使用超时参数 (4098)
-
忙碌 (4099)
-
方法保留 (4100 32767)
-
供应商特定 (32768 65535)
备注
UAC 筛选可能会限制对 Msvm_ConcreteJob 类的访问。 有关详细信息,请参阅 用户帐户控制和 WMI。
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows 8 [仅限桌面应用] |
最低受支持的服务器 |
Windows Server 2012 [仅限桌面应用] |
命名空间 |
Root\Virtualization\V2 |
MOF |
|
DLL |
|