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