CIM_IPProtocolEndpoint 类的 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)
-
-
Job [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 |
|