CIM_RemoteServiceAccessPoint 类的 RequestStateChange 方法
请求将元素的状态更改为 RequestedState 参数中指定的值。 当请求的状态更改发生时,元素的 EnabledState 和 RequestedState 将相同。 多次调用 RequestChangeState 方法可能会导致早期请求被覆盖或丢失。 如果返回 0,则表明任务已成功完成,并且不需要使用 ConcreteJob。 如果返回 4096 (0x1000),则表明任务需要一些时间才能完成,此时将创建 ConcreteJob,并在输出参数 Job 中返回其引用。 任何其他返回代码均指示错误条件。
语法
uint32 RequestStateChange(
[in] uint16 RequestedState,
[out] CIM_ConcreteJob Job,
[in] datetime TimeoutPeriod
);
参数
-
RequestedState [in]
-
元素的最后请求状态或所需状态。 如果 RequestStateChange 方法的返回代码为 0(“已完成且无错误”)、3(“超时”)或 4096 (0x1000) (“作业已启动”),则此信息将放入实例的 RequestedState 属性中。 有关 RequestedState 值的详细说明,请参阅 EnabledState 和 RequestedState 属性的说明。
-
启用 (2)
-
已禁用 (3)
-
关闭 (4)
-
脱机 (6)
-
测试 (7)
-
延迟 (8)
-
静止 (9)
-
重新启动 (10)
-
重置 (11)
-
DMTF 保留 (12 32767)
-
供应商预留 (32768 65535)
-
-
作业 [out]
-
包含对作业的引用的 CIM_ConcreteJob(如果任务完成,可以为 null)。
-
TimeoutPeriod [in]
-
一个超时时间段,指定客户端期望转换到新状态所花费的最大时间。 间隔格式必须用于指定此时间段。 值为 0 或 null 参数表示客户端没有转换时间要求。 如果此属性不包含 0 或 null,并且实现不支持此参数,则必须返回“使用超时参数不支持”的返回代码。
返回值
-
已完成,无错误 (0)
-
不支持 (1)
-
未知或未指定错误 (2)
-
无法在超时期限内完成 (3)
-
失败 (4)
-
无效参数 (5)
-
正在使用中 (6)
-
DMTF 保留 (7 4095)
-
检查的方法参数 - 作业已启动 (4096)
-
无效的状态转换 (4097)
-
不支持使用超时参数 (4098)
-
忙碌 (4099)
-
方法保留 (4100 32767)
-
供应商特定 (32768 65535)
要求
最低受支持的客户端 |
Windows 8 |
支持的最低服务器版本 |
Windows Server 2012 |
命名空间 |
Root\standardcimv2 |
MOF |
|
DLL |
|