CIM_LogicalDevice 类的 OnlineDevice 方法

OnlineDevice 方法已被弃用，取而代之的是与此方法提供的功能直接重叠的更通用的 RequestStateChange 方法。

请求将 LogicalDevice 联机（“联机”输入参数 = TRUE）或脱机 (= FALSE)。 “联机”(Online) 表示设备已准备好接受请求，并且正在正常运行。 在这种情况下，设备的 Availability 属性将设置为 3（“正在运行/全功率”）。 “脱机”(Offline) 表示设备已启动并正常运行，但未处理功能请求。 在脱机状态下，设备可能能够运行诊断或生成操作警报。 例如，在打印机上推送“脱机”按钮时，设备无法再处理打印作业，但可用于诊断或维护。

如果此方法成功，则设备的 Availability 和 AdditionalAvailability 属性应反映更新后的状态。 如果尝试使设备联机或脱机时发生故障，它应保持其当前状态。 如果请求失败，IE 不应使设备处于不确定状态。 将设备从“脱机”模式恢复为“联机”模式时，应尽可能将设备还原到其上次“联机”状态。 只有 EnabledState/StatusInfo 状态为“已启用”且已配置的设备才能联机或脱机。

如果成功，OnlineDevice 应返回 0；如果请求根本不受支持，返回 1；如果请求因设备的当前状态而不受支持，返回 2；如果发生任何其他错误，则返回其他值。 在子类中，可以使用方法上的 ValueMap 限定符指定可能的返回代码集。 ValueMap 内容为 \'translated\' 的字符串也可以在子类中指定为 Values 数组限定符。

请注意，此方法的函数与 RequestedState 属性重叠。 RequestedState 已添加到模型中，用来维护最后一个状态请求的记录（即持久值）。 调用 OnlineDevice 方法时，应适当设置 RequestedState 属性。

语法

uint32 OnlineDevice(
  [in] boolean Online
);

参数

Online [in]

如果为 TRUE，则使设备联机，如果为 FALSE，则使设备脱机。

返回值

待定

要求

另请参阅

CIM_LogicalDevice