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)

要求

另请参阅

CIM_IPProtocolEndpoint