CIM_Battery 类

CIM_Battery类表示电池逻辑设备的功能和管理。 此类适用于笔记本电脑系统和其他内部和外部电池中的电池。

重要

DMTF (分布式管理工作组) CIM (Common Information Model) 类是生成 WMI 类的父类。 WMI 目前仅支持 CIM 2.x 版本架构。

以下语法从托管对象格式 (MOF) 代码简化而来，包括所有继承属性。 属性按字母顺序列出，而不是按 MOF 顺序列出。

语法

[Abstract, UUID("{8502C548-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class CIM_Battery : CIM_LogicalDevice
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  uint16   Availability;
  uint32   ConfigManagerErrorCode;
  boolean  ConfigManagerUserConfig;
  string   CreationClassName;
  string   DeviceID;
  uint16   PowerManagementCapabilities[];
  boolean  ErrorCleared;
  string   ErrorDescription;
  uint32   LastErrorCode;
  string   PNPDeviceID;
  boolean  PowerManagementSupported;
  uint16   StatusInfo;
  string   SystemCreationClassName;
  string   SystemName;
  uint16   BatteryStatus;
  uint16   Chemistry;
  uint32   DesignCapacity;
  uint64   DesignVoltage;
  uint16   EstimatedChargeRemaining;
  uint32   EstimatedRunTime;
  uint32   ExpectedLife;
  uint32   FullChargeCapacity;
  uint32   MaxRechargeTime;
  string   SmartBatteryVersion;
  uint32   TimeOnBattery;
  uint32   TimeToFullCharge;
};

成员

CIM_Battery类包含以下类型的成员：

• 方法
• 属性

方法

CIM_Battery类具有这些方法。

方法	说明
重置	请求重置逻辑设备。 未由 WMI 实现。
SetPowerState	定义逻辑设备的所需电源状态，以及设备何时应处于该状态。 未由 WMI 实现。

属性

CIM_Battery类具有以下属性。

可用性

数据类型： uint16

访问类型：只读

限定符： MappingStrings (“MIF。DMTF|操作状态|003.5“、”MIB”。IETF|HOST-RESOURCES-MIB.hrDeviceStatus“)

设备的可用性和状态。

此属性继承自 CIM_LogicalDevice。

其他 (1)

未知 (2)

运行/全能 (3)

警告 (4)

在测试 (5)

不适用 (6)

关机 (7)

下线 (8)

下班 (9)

降级 (10)

未安装 (11)

安装错误 (12)

省电 - 未知 (13)

已知设备处于省电模式，但其确切状态未知。

省电 - 低功率模式 (14)

设备处于省电状态，但仍正常运行，并可能表现出性能下降。

省电 - 备用 (15)

设备无法正常运行，但可以快速提供全功率。

Power Cycle (16)

省电 - 警告 (17)

设备处于警告状态，同时处于省电模式。

已暂停 (18)

设备已暂停。

未就绪 (19)

设备未准备就绪。

未配置 (20)

设备未配置。

静止 (21)

设备安静。

BatteryStatus

数据类型： uint16

访问类型：只读

限定符： MappingStrings (“MIF。DMTF|便携式电池|002.14“)

电池充电状态的说明。 值 10 在 CIM 架构中无效，表示桌面管理界面中未安装电池 (DMI) 。 在这种情况下，不应实例化对象。

其他 (1)

其他。

未知 (2)

未知。

完全充电 (3)

完全收费。

低 (4)

低。

关键 (5)

关键。

充电 (6)

充电。

充电和高 (7)

充电和高。

充电和低 (8)

充电和低。

充电和关键 (9)

充电和关键。

未定义的 (10)

未定义。

部分收费 (11)

部分收费。

Caption

数据类型： 字符串

访问类型：只读

限定符： MaxLen (64) 、 DisplayName (“Caption”)

对象的简短文本说明。

此属性继承自 CIM_ManagedSystemElement。

化学

数据类型： uint16

访问类型：只读

限定符： MappingStrings (“MIF。DMTF|便携式电池|002.7“)

描述电池化学的枚举。

其他 (1)

其他。

未知 (2)

未知。

铅酸 (3)

铅酸。

镍基 ( 4)

镍钙。

镍金属氢化物 (5)

镍金属氢化物。

锂离子 (6)

锂离子。

锌空气 (7)

锌空气。

锂聚合物 (8)

锂聚合物。

ConfigManagerErrorCode

数据类型： uint32

访问类型：只读

限定符： 架构 (“Win32”)

Win32 Configuration Manager错误代码。

此属性继承自 CIM_LogicalDevice。

此设备正常工作。 (0)

此设备配置不正确。 (1)

Windows无法加载此设备的驱动程序。 (2)

该设备的驱动程序可能已损坏，或者系统内存不足或其他资源不足。 (3)

此设备无法正常工作。 其中一个驱动程序或注册表可能已损坏。 (4)

此设备的驱动程序需要Windows无法管理的资源。 (5)

此设备的启动配置与其他设备冲突。 (6)

无法筛选。 (7)

设备驱动程序加载程序缺失。 (8)

此设备无法正常工作，因为控制固件报告设备的资源不正确。 (9)

该设备无法启动。 (10)

此设备失败。 (11)

该设备找不到足够可用资源。 (12)

Windows无法验证此设备的资源。 (13)

重新启动计算机之前，该设备无法正常工作。 (14)

此设备无法正常工作，因为可能存在重新枚举问题。 (15)

Windows 无法识别该设备使用的所有资源。 (16)

此设备请求未知资源类型。 (17)

重新安装此设备的驱动程序。 (18)

使用 VxD 加载程序失败。 (19)

注册表可能已损坏。 (20)

系统故障：尝试更改此设备的驱动程序。 如果不起作用，请参阅硬件文档。 Windows 正在删除这个设备。 (21)

该设备已被禁用。 (22)

系统故障：尝试更改此设备的驱动程序。 如果不起作用，请参阅硬件文档。 (23)

该设备不存在、运行不正确、或者没有安装所有的驱动程序。 (24)

Windows仍在设置此设备。 (25)

Windows仍在设置此设备。 (26)

此设备没有有效的日志配置。 (27)

未安装该设备的驱动程序。 (28)

该设备已被禁用，原因是，设备的固件没有提供必需的资源。 (29)

此设备使用另一台设备正在使用的中断请求 (IRQ) 资源。 (30)

由于 Windows 无法加载这个设备所需的驱动程序，导致这个设备工作异常。 (31)

ConfigManagerUserConfig

数据类型： 布尔值

访问类型：只读

限定符： 架构 (“Win32”)

如果 为 TRUE，则设备使用用户定义的配置。

此属性继承自 CIM_LogicalDevice。

CreationClassName

数据类型： 字符串

访问类型：只读

限定符： CIM_Key

在创建实例时使用的类或子类的名称。 与类的其他键属性一起使用时，此属性允许唯一标识类及其子类的所有实例。

此属性继承自 CIM_LogicalDevice。

说明

数据类型： 字符串

访问类型：只读

限定符： DisplayName (“Description”)

对象的文本说明。

此属性继承自 CIM_ManagedSystemElement。

DesignCapacity

数据类型： uint32

访问类型：只读

限定符： MappingStrings (“MIF。DMTF|便携式电池|002.8“) ， 单位 (”milliwatt-hours“)

设计了以米瓦特小时为单位的电池容量。 如果不支持此属性，请输入 0。

DesignVoltage

数据类型： uint64

访问类型：只读

限定符： MappingStrings (“MIF。DMTF|便携式电池|002.9“) ， 单位 (”millivolts“)

以千伏为单位设计电池的电压。 如果不支持此属性，请输入 0。

有关在脚本中使用 uint64 值的详细信息，请参阅 WMI 中的脚本。

DeviceID

数据类型： 字符串

访问类型：只读

限定符： CIM_Key

用于唯一命名逻辑设备的地址或其他标识信息。

此属性继承自 CIM_LogicalDevice。

ErrorCleared

数据类型： 布尔值

访问类型：只读

如果 为 TRUE，则现在清除 LastErrorCode 属性中报告的错误。

此属性继承自 CIM_LogicalDevice。

ErrorDescription

数据类型： 字符串

访问类型：只读

自由格式字符串，提供有关 LastErrorCode 属性中记录的错误的信息，以及要执行的纠正措施。

此属性继承自 CIM_LogicalDevice。

EstimatedChargeRemaining

数据类型： uint16

访问类型：只读

限定符： 单位 (“percent”)

剩余完整费用的估计百分比。

EstimatedRunTime

数据类型： uint32

访问类型：只读

限定符： MappingStrings (“MIF。DMTF|便携式电池|002.15“) ， 单位 (”分钟“)

估计的时间（以分钟为单位）在当前负载条件下耗尽电池电量（如果实用工具电源关闭、断开并保持关闭）或笔记本电脑与电源断开连接。

ExpectedLife

数据类型： uint32

访问类型：只读

限定符： 单位 (“分钟”)

电池的预期生存期（以分钟为单位）假设电池已完全充电。 此属性表示电池的总预期寿命，而不是 由 EstimatedRunTime 属性指示的当前剩余寿命。

FullChargeCapacity

数据类型： uint32

访问类型：只读

限定符： MappingStrings (“MIF。DMTF|便携式电池|002.11“) ， 单位 (”米瓦特小时“)

电池的全充电容量（以米瓦特小时为单位）。 将此值与 DesignCapacity 属性进行比较，以确定电池何时需要更换。 电池的生命周期通常是 当 FullChargeCapacity 属性低于 DesignCapacity 属性的 80% 时。 如果不支持此属性，请输入 0。

InstallDate

数据类型： datetime

访问类型：只读

限定符： MappingStrings (“MIF。DMTF|ComponentID|001.5“) ， DisplayName (”安装日期“)

指示对象安装的时间。 缺少值并不表示未安装对象。

此属性继承自 CIM_ManagedSystemElement。

LastErrorCode

数据类型： uint32

访问类型：只读

逻辑设备报告的最后一个错误代码。

此属性继承自 CIM_LogicalDevice。

MaxRechargeTime

数据类型： uint32

访问类型：只读

限定符： 单位 (“分钟”)

最大时间（以分钟为单位），以完全充电电池。 此属性表示充电完全耗尽的电池的时间，而不是 TimeToFullCharge 属性中指示的当前剩余充电时间。

名称

数据类型： 字符串

访问类型：只读

限定符： DisplayName (“Name”)

对象的已知标签。 当子类化时，可以将此属性重写为键属性。

此属性继承自 CIM_ManagedSystemElement。

PNPDeviceID

数据类型： 字符串

访问类型：只读

限定符： 架构 (“Win32”)

指示逻辑设备的 Win32 即插即用设备标识符。

示例：“*PNP030b”

此属性继承自 CIM_LogicalDevice。

PowerManagementCapabilities

数据类型： uint16 数组

访问类型：只读

指示逻辑设备的特定电源相关功能。

此属性继承自 CIM_LogicalDevice。

未知 (0)

与电源相关的容量未知。

不支持 (1)

此设备不支持与电源相关的容量。

禁用 (2)

已禁用与电源相关的容量。

已启用 (3)

电源管理功能当前已启用，但确切的功能集未知或信息不可用。

自动输入的节能模式 (4)

设备可以根据使用情况或其他条件更改其电源状态。

Power State Settable (5)

支持 SetPowerState 方法。 此方法在父 CIM_LogicalDevice 类上找到，并且可以实现。 有关详细信息，请参阅 设计托管对象格式 (MOF) 类。

支持 (6)

可以使用 PowerState 参数设置为 5 (“Power Cycle”) 调用 SetPowerState 方法。

支持的计时开机 (7)

可以使用 PowerState 参数设置为 5 (“Power Cycle”) 调用 SetPowerState 方法，并将时间参数设置为特定日期和时间，或打开电源的时间间隔。

PowerManagementSupported

数据类型： 布尔值

访问类型：只读

如果 为 TRUE，则设备可以进行电源管理，即进入节能状态。 如果 为 FALSE，则整数值 1 (“不支持”) 应该是 PowerManagementCapabilities 数组中唯一的条目。

此属性不指示当前是否启用了电源管理功能，或者是否已启用哪些功能受支持。 有关详细信息，请参阅 PowerManagementCapabilities 数组。

此属性继承自 CIM_LogicalDevice。

SmartBatteryVersion

数据类型： 字符串

访问类型：只读

限定符： MaxLen (64) ，MappingStrings (“MIF。DMTF|便携式电池|002.10“)

此电池支持的智能电池数据规范版本号。 如果电池不支持此函数，该值应留空。

Status

数据类型： 字符串

访问类型：只读

限定符： MaxLen (10) ， DisplayName (“Status”)

指示对象的当前状态的字符串。 可以定义操作和非操作状态。 操作状态可以包括“确定”、“已降级”和“Pred Fail”。 “Pred Fail”表示元素正常运行，但预测故障 (例如启用了 SMART 的硬盘驱动器) 。

非操作状态可能包括“错误”、“正在启动”、“正在停止”和“服务”。 “服务”可在磁盘镜像重新加密、重新加载用户权限列表或其他管理工作期间应用。 并非所有此类工作都处于联机状态，但托管元素既不是“正常”，也不是在其他状态之一。

此属性继承自 CIM_ManagedSystemElement。

包括以下值：

确定 (“确定”)

错误 (“错误”)

降级 (“已降级”)

未知 (“未知”)

Pred Fail (“Pred Fail”)

启动 (“启动”)

停止 (“停止”)

服务 (“服务”)

(“强调 ”)

NonRecover (“NonRecover ”)

无联系人 (“无联系人”)

Lost Comm (“Lost Comm”)

StatusInfo

数据类型： uint16

访问类型：只读

限定符： MappingStrings (“MIF。DMTF|操作状态|003.3“)

逻辑设备的状态。 如果此属性不适用于逻辑设备，则应使用值 5 (“不适用”) 。

此属性继承自 CIM_LogicalDevice。

其他 (1)

未知 (2)

已启用 (3)

禁用 (4)

不适用 (5)

SystemCreationClassName

数据类型： 字符串

访问类型：只读

限定符： 传播 的 (“CIM_System。CreationClassName“) ， CIM_Key

范围系统的创建类名称。

此属性继承自 CIM_LogicalDevice。

SystemName

数据类型： 字符串

访问类型：只读

限定符： 传播 的 (“CIM_System。名称“) ， CIM_Key

范围系统的名称。

此属性继承自 CIM_LogicalDevice。

TimeOnBattery

数据类型： uint32

访问类型：只读

限定符： 单位 (“秒”)

由于计算机系统的 UPS 上次切换到电池电源，或者系统或 UPS 上次重启的时间，以秒为单位，以秒为单位。 如果电池处于“联机”状态，则返回值为 0。

TimeToFullCharge

数据类型： uint32

访问类型：只读

限定符： MappingStrings (“MIF。DMTF|便携式电池|002.16“) ， 单位 (”分钟“)

剩余时间（以分钟为单位）以当前充电速率和使用方式完全充电电池。

注解

CIM_Battery类派生自 CIM_LogicalDevice。

WMI 不实现此类。 有关派生自 CIM_Battery的类的详细信息，请参阅 Win32 类。

本文档派生自 DMTF 发布的 CIM 类说明。 Microsoft 可能已更改以更正次要错误、符合 Microsoft SDK 文档标准或提供更多信息。

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
命名空间	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

另请参阅

CIM_LogicalDevice