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
WindowsVirtualization.V2.mof
DLL
Vmms.exe

另请参阅

Msvm_ConcreteJob