CIM_NetworkPipe 类的 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)

要求

另请参阅

CIM_NetworkPipe