CIM_LogicalDevice 类的 OnlineDevice 方法
OnlineDevice 方法已被弃用，而不是与此方法提供的功能直接重叠的更常规 RequestStateChange 方法。
请求将 LogicalDevice 联机（“Online”输入参数 = TRUE）或脱机（= FALSE）。 “Online”表示设备已准备好接受请求，并且正常运行。 在这种情况下，Device\'s Availability 属性将设置为值 3（“Running/Full Power”）。 “脱机”表示设备已启动并正常运行，但不处理功能请求。 处于脱机状态，设备可能能够运行诊断或生成作警报。 例如，在打印机上推送“脱机”按钮时，设备不再可用于处理打印作业，但可用于诊断或维护。
如果此方法成功，则 Device\的可用性和 AdditionalAvailability 属性应反映更新的状态。 如果尝试使设备联机或脱机时发生故障，它应保持其当前状态。 IE（如果失败）请求不应使设备处于不确定状态。 从“脱机”模式将设备恢复为“联机”时，设备应还原到其最后一个“联机”状态（如果可能）。 只有 EnabledState/StatusInfo 为“Enabled”且已配置的设备才能联机或脱机。
如果成功，则 OnlineDevice 应返回 0;如果请求根本不受支持，则返回 1;如果由于设备的当前状态而不支持请求，则返回 2;如果发生任何其他错误，则返回其他一些值。 在子类中，可以使用方法上的 ValueMap 限定符指定可能的返回代码集。 ValueMap 内容为 \'translated\' 的字符串也可以在子类中指定为 Values 数组限定符。
请注意，此方法的函数与 RequestedState 属性重叠。 RequestedState 已添加到模型中，用于维护最后一个状态请求的记录（即持久值）。 调用 OnlineDevice 方法应相应地设置 RequestedState 属性。
语法
uint32 OnlineDevice(
[in] boolean Online
);
参数
-
Online [in]
-
如果为 TRUE，则使设备联机（如果为 FALSE）使设备脱机。
返回值
待定
要求
| 支持的最低客户端 |
Windows 8 |
| 支持的最低服务器 |
Windows Server 2012 |
| Namespace |
Root\standardcimv2 |
| MOF |
|
| DLL |
|