MSFT_StorageJob 类的 RequestStateChange 方法
请求将作业的状态更改为 RequestedState 参数中指定的值。
语法
UInt32 RequestStateChange(
[in] UInt16 RequestedState,
[out] String ExtendedStatus
);
参数
RequestedState [in]
新状态。
| 值 | 含义 |
|---|---|
| 开始 2 | 此值将 JobState 属性的值更改为 Running。 |
| 暂停 3 | 此值暂时停止作业。 目的是随后通过第二次调用 RequestStateChange 重新启动作业，并将 RequestedState 参数设置为 Start。 作业在暂停时可能会进入 服务 状态。 (这是特定于作业的。) |
| 终止 4 | 此值可干净地停止作业、保存数据、保留状态，并以有序的方式关闭所有基础进程。 |
| 杀死 5 | 此值立即终止作业，无需保存数据或保留状态。 |
| 服务 6 | 此值将作业置于特定于供应商的服务状态。 可以重启作业。 |
| DMTF 保留 7..32767 | 介于 7 和 32767 (（含) ）的值是为 DMTF 保留的。 |
| 供应商保留 32768..65535 | 32768 到 65535 之间的值 (包含) 保留给供应商。 |
ExtendedStatus [out]
包含嵌入 MSFT_StorageExtendedStatus 对象的字符串。
此参数允许存储提供程序返回特定于实现的扩展 () 错误信息。
返回值
成功 (0)
不支持 (1)
未指定的错误 (2)
超时 (3)
失败 (4)
参数 (5) 无效
已检查方法参数 - 作业 启动 (4096)
不支持大小 (4097)
访问被拒绝 (40001)
没有足够的资源来完成操作。 (40002)
无法连接到存储提供程序。 (46000)
存储提供程序无法连接到存储子系统。 (46001)
注解
如果多次调用此方法，早期请求可能会被覆盖或丢失。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 8 [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2012 [仅限桌面应用] |
| 命名空间 | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |