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;否则，将返回错误。
-
已完成，无错误 (0)
-
不支持 (1)
-
未知或未指定错误 (2)
-
无法在超时期限内完成 (3)
-
失败 (4)
-
参数 (5) 无效
-
In Use (6)
-
DMTF 保留 (。)
-
已检查方法参数 - 作业 启动 (4096)
-
无效状态转换 (4097)
-
(4098) 不支持使用超时参数
-
繁忙 (4099)
-
方法保留 (4100..32767)
-
供应商特定 (32768..65535)
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows 8.1 |
| 最低受支持的服务器 |
Windows Server 2012 R2 |
| 命名空间 |
Root\virtualization\v2 |
| MOF |
|
| DLL |
|