CIM_Battery-Klasse

  • Artikel

Die CIM_Battery-Klasse stellt die Funktionen und die Verwaltung des logischen Akkugeräts dar. Diese Klasse gilt für Akkus in Laptopsystemen und andere interne und externe Batterien.

Wichtig

Die CIM-Klassen (Common Information Model) von DMTF (Distributed Management Task Force) sind die übergeordneten Klassen, auf denen WMI-Klassen erstellt werden. WMI unterstützt derzeit nur die CIM 2.x-Versionsschemas.

Die folgende Syntax wird durch MOF-Code (Managed Object Format) vereinfacht und schließt alle geerbten Eigenschaften ein. Eigenschaften werden in alphabetischer Reihenfolge und nicht in MOF-Reihenfolge aufgeführt.

Syntax

[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;
};

Member

Die CIM_Battery-Klasse verfügt über die folgenden Membertypen:

Methoden

Die CIM_Battery-Klasse verfügt über diese Methoden.

Methode BESCHREIBUNG
Zurücksetzen Fordert eine Zurücksetzung des logischen Geräts an. Nicht von WMI implementiert.
SetPowerState Definiert den gewünschten Energiezustand für ein logisches Gerät und wann das Gerät in diesen Zustand versetzt werden soll. Nicht von WMI implementiert.

Eigenschaften

Die CIM_Battery-Klasse verfügt über diese Eigenschaften.

Verfügbarkeit

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("MIF. DMTF| Betriebszustand|003.5", "MIB. IETF| HOST-RESOURCES-MIB.hrDeviceStatus")

Verfügbarkeit und status des Geräts.

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

Sonstiges (1)

Unbekannt (2)

Running/Full Power (3)

Warnung (4)

Im Test (5)

Nicht zutreffend (6)

Ausschalten (7)

Offline (8)

Off Duty (9)

Beeinträchtigt (10)

Nicht installiert (11)

Installationsfehler (12)

Energiesparen – Unbekannt (13)

Es ist bekannt, dass sich das Gerät in einem Energiesparmodus befindet, aber seine genaue status ist unbekannt.

Energiesparen – Energiesparmodus (14)

Das Gerät befindet sich im Energiesparmodus, funktioniert aber weiterhin und kann eine beeinträchtigte Leistung aufweisen.

Energiesparen – Standby ( 15)

Das Gerät funktioniert nicht, konnte aber schnell zur vollen Leistung gebracht werden.

Stromversorgung (16)

Energiesparen – Warnung (17)

Das Gerät befindet sich in einem Warnzustand, aber auch im Energiesparmodus.

Angehalten (18)

Das Gerät wird angehalten.

Nicht bereit (19)

Das Gerät ist nicht bereit.

Nicht konfiguriert (20)

Das Gerät ist nicht konfiguriert.

Ruhen (21)

Das Gerät ist leise.

BatteryStatus

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("MIF. DMTF| Tragbarer Akku|002,14")

Beschreibung der Akkuladung status. Der Wert 10 ist im CIM-Schema ungültig, was darstellt, dass kein Akku in DMI (Desktop Management Interface) installiert wird. In diesem Fall sollte das Objekt nicht instanziiert werden.

Sonstiges (1)

Sonstiges

Unbekannt (2)

Unbekannt

Vollständig aufgeladen (3)

Vollständig in Rechnung gestellt.

Niedrig (4)

Niedrig.

Kritisch (5)

Kritisch.

Aufladen (6)

Laden.

Aufladen und Hoch (7)

Aufladen und hoch.

Aufladen und Niedrig (8)

Aufladen und niedrig.

Aufladen und kritisch (9)

Aufladen und kritisch.

Undefined (10)

Nicht definiert.

Teilweise berechnet (11)

Teilweise in Rechnung gestellt.

Caption

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen (64), DisplayName ("Caption")

Eine kurze Textbeschreibung des Objekts.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Chemie

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("MIF. DMTF| Tragbarer Akku|002,7")

Enumeration, die die Chemie der Batterie beschreibt.

Sonstiges (1)

Sonstiges

Unbekannt (2)

Unbekannt

Bleisäure (3)

Bleisäure.

Nickel-Kadmium (4)

Nickel-Kadmium.

Nickelmetallhydrid (5)

Nickelmetallhydrid.

Lithium-Ionen (6)

Lithium-Ionen.

Zinkluft (7)

Zinkluft.

Lithium-Polymer (8)

Lithium-Polymer.

ConfigManagerErrorCode

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schema ("Win32")

Win32 Configuration Manager Fehlercode.

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

Dieses Gerät funktioniert ordnungsgemäß. (0)

Dieses Gerät ist nicht ordnungsgemäß konfiguriert. (1)

Windows kann den Treiber für dieses Gerät nicht laden. (2)

Der Treiber für dieses Gerät ist möglicherweise beschädigt, oder Ihr System verfügt möglicherweise über wenig Arbeitsspeicher oder andere Ressourcen. (3)

Dieses Gerät funktioniert nicht ordnungsgemäß. Einer der Treiber oder Ihre Registrierung ist möglicherweise beschädigt. (4)

Der Treiber für dieses Gerät benötigt eine Ressource, die Windows nicht verwalten kann. (5)

Die Startkonfiguration für dieses Gerät ist in Konflikt mit anderen Geräten. (6)

Filter kann nicht gefiltert werden. (7)

Das Treiberladeprogramm für das Gerät fehlt. (8)

Dieses Gerät funktioniert nicht ordnungsgemäß, da die steuernde Firmware die Ressourcen für das Gerät falsch meldet. (9)

Dieses Gerät kann nicht gestartet werden. (10)

Bei diesem Gerät ist ein Fehler aufgetreten. (11)

Dieses Gerät kann nicht genügend freie Ressourcen finden, die es verwenden kann. (12)

Windows kann die Ressourcen dieses Geräts nicht überprüfen. (13)

Dieses Gerät kann erst dann ordnungsgemäß funktionieren, wenn Sie den Computer neu starten. (14)

Dieses Gerät funktioniert nicht ordnungsgemäß, da wahrscheinlich ein Problem mit einer erneuten Enumeration vorliegt. (15)

Windows kann nicht alle Ressourcen identifizieren, die von diesem Gerät verwendet werden. (16)

Dieses Gerät fragt nach einem unbekannten Ressourcentyp. (17)

Installieren Sie die Treiber für dieses Gerät neu. (18)

Fehler beim Verwenden des VxD-Ladeprogramms. (19)

Ihre Registrierung ist möglicherweise beschädigt. (20)

Systemfehler: Versuchen Sie, den Treiber für dieses Gerät zu ändern. Wenn dies nicht funktioniert, lesen Sie ihre Hardwaredokumentation. Windows entfernt dieses Gerät. (21)

Dieses Gerät ist deaktiviert. (22)

Systemfehler: Versuchen Sie, den Treiber für dieses Gerät zu ändern. Wenn dies nicht funktioniert, lesen Sie ihre Hardwaredokumentation. (23)

Dieses Gerät ist nicht vorhanden, funktioniert nicht ordnungsgemäß oder hat nicht alle Treiber installiert. (24)

Windows richtet dieses Gerät noch ein. (25)

Windows richtet dieses Gerät noch ein. (26)

Dieses Gerät verfügt nicht über eine gültige Protokollkonfiguration. (27)

Die Treiber für dieses Gerät sind nicht installiert. (28)

Dieses Gerät ist deaktiviert, da die Firmware des Geräts nicht die erforderlichen Ressourcen bereitgestellt hat. (29)

Dieses Gerät verwendet eine Interrupt Request (IRQ)-Ressource, die von einem anderen Gerät verwendet wird. (30)

Dieses Gerät funktioniert nicht ordnungsgemäß, da Windows die für dieses Gerät erforderlichen Treiber nicht laden kann. (31)

ConfigManagerUserConfig

Datentyp: boolean

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schema ("Win32")

Bei TRUE verwendet das Gerät eine benutzerdefinierte Konfiguration.

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

CreationClassName

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: CIM_Key

Name der Klasse oder Unterklasse, die bei der Erstellung einer instance verwendet wird. Bei Verwendung mit anderen Schlüsseleigenschaften der -Klasse ermöglicht diese Eigenschaft die eindeutige Identifizierung aller Instanzen der -Klasse und ihrer Unterklassen.

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

Beschreibung

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("Description")

Eine Textbeschreibung des Objekts.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

DesignCapacity

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("MIF. DMTF| Tragbarer Akku|002.8"), Einheiten ("Milliwattstunden")

Entworfene Kapazität der Batterie in Milliwattstunden. Wenn diese Eigenschaft nicht unterstützt wird, geben Sie 0 ein.

DesignVoltage

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("MIF. DMTF| Tragbarer Akku|002.9"), Einheiten ("Millivolt")

Ausgelegte Spannung der Batterie in Millivolt. Wenn dieses Attribut nicht unterstützt wird, geben Sie 0 ein.

Weitere Informationen zur Verwendung von uint64-Werten in Skripts finden Sie unter Skripterstellung in WMI.

DeviceID

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: CIM_Key

Adresse oder andere identifizierende Informationen, um das logische Gerät eindeutig zu benennen.

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

ErrorCleared

Datentyp: boolean

Zugriffstyp: Schreibgeschützt

Wenn TRUE, wird der in der LastErrorCode-Eigenschaft gemeldete Fehler jetzt gelöscht.

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

ErrorDescription

Datentyp: string

Zugriffstyp: Schreibgeschützt

Eine Freiformzeichenfolge, die Informationen über den in der LastErrorCode-Eigenschaft aufgezeichneten Fehler und auszuführende Korrekturmaßnahmen bereitstellt.

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

EstimatedChargeRemaining

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Qualifizierer: Einheiten ("Prozent")

Geschätzter Prozentsatz der verbleibenden vollen Gebühr.

EstimatedRunTime

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("MIF. DMTF| Tragbarer Akku|002.15"), Einheiten ("Minuten")

Geschätzte Zeit in Minuten, bis die Akkuladung unter den aktuellen Lastbedingungen erschöpft ist, wenn die Stromversorgung ausgeschaltet ist, verloren geht und aus bleibt oder wenn ein Laptop von einer Stromquelle getrennt wird.

ExpectedLife

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: Einheiten ("Minuten")

Die erwartete Lebensdauer des Akkus in Minuten, vorausgesetzt, dass der Akku vollständig aufgeladen ist. Diese Eigenschaft stellt die erwartete Gesamtlebensdauer des Akkus dar, nicht die aktuelle Restlebensdauer, die durch die EstimatedRunTime-Eigenschaft angegeben wird.

FullChargeCapacity

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("MIF. DMTF| Tragbarer Akku|002.11"), Einheiten ("Milliwattstunden")

Die volle Ladekapazität des Akkus in Milliwattstunden. Vergleichen Sie diesen Wert mit der DesignCapacity-Eigenschaft , um zu bestimmen, wann der Akku ausgetauscht werden muss. Die Endlebensdauer eines Akkus liegt in der Regel dann vor, wenn die FullChargeCapacity-Eigenschaft unter 80 Prozent der DesignCapacity-Eigenschaft fällt. Wenn diese Eigenschaft nicht unterstützt wird, geben Sie 0 ein.

InstallDate

Datentyp: datetime

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Installationsdatum")

Gibt an, wann das Objekt installiert wurde. Das Fehlen eines Werts gibt nicht an, dass das Objekt nicht installiert ist.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

LastErrorCode

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Letzter Fehlercode, der vom logischen Gerät gemeldet wurde.

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

MaxRechargeTime

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: Einheiten ("Minuten")

Maximale Zeit in Minuten, um den Akku vollständig aufzuladen. Diese Eigenschaft stellt die Zeit zum Aufladen eines vollständig verbrauchten Akkus dar, nicht die aktuelle verbleibende Ladezeit, wie in der TimeToFullCharge-Eigenschaft angegeben.

Name

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("Name")

Bezeichnung, unter der das Objekt bekannt ist. Bei unterklassigen Klassen kann diese Eigenschaft als Schlüsseleigenschaft überschrieben werden.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

PNPDeviceID

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schema ("Win32")

Gibt den Win32-Plug & Play Gerätebezeichner des logischen Geräts an.

Beispiel: "*PNP030b"

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

PowerManagementCapabilities

Datentyp: uint16-Array

Zugriffstyp: Schreibgeschützt

Gibt die spezifischen energiebezogenen Funktionen des logischen Geräts an.

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

Unbekannt (0)

Die leistungsbezogenen Kapazitäten sind unbekannt.

Nicht unterstützt (1)

Energiebezogene Kapazitäten werden für dieses Gerät nicht unterstützt.

Deaktiviert (2)

Energiebezogene Kapazitäten wurden deaktiviert.

Aktiviert (3)

Die Energieverwaltungsfeatures sind derzeit aktiviert, aber der genaue Featuresatz ist unbekannt, oder die Informationen sind nicht verfügbar.

Energiesparmodi werden automatisch eingegeben (4)

Das Gerät kann seinen Energiezustand basierend auf der Nutzung oder anderen Kriterien ändern.

Power State Settable (5)

Die SetPowerState-Methode wird unterstützt. Diese Methode befindet sich in der übergeordneten CIM_LogicalDevice-Klasse und kann implementiert werden. Weitere Informationen finden Sie unter Entwerfen von MOF-Klassen (Managed Object Format).

Power Cycling Wird unterstützt (6)

Die SetPowerState-Methode kann aufgerufen werden, wenn der PowerState-Parameter auf 5 ("Power Cycle") festgelegt ist.

Timed Power On Supported (7)

Die SetPowerState-Methode kann aufgerufen werden, wenn der PowerState-Parameter auf 5 ("Power Cycle") und der Time-Parameter auf ein bestimmtes Datum und eine bestimmte Uhrzeit oder ein bestimmtes Intervall für das Einschalten festgelegt ist.

PowerManagementSupported

Datentyp: Boolesch

Zugriffstyp: Schreibgeschützt

Wenn TRUE, kann das Gerät energieverwaltet, d. h. in einen Energiesparzustand versetzt werden. Bei FALSE sollte der ganzzahlige Wert 1 ("Nicht unterstützt") der einzige Eintrag im PowerManagementCapabilities-Array sein.

Diese Eigenschaft gibt nicht an, ob Energieverwaltungsfeatures derzeit aktiviert sind oder falls aktiviert, welche Features unterstützt werden. Weitere Informationen finden Sie im PowerManagementCapabilities-Array .

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

SmartBatteryVersion

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen (64), MappingStrings ("MIF. DMTF| Tragbarer Akku|002.10")

Smart Battery Data-Specification-Versionsnummer, die von diesem Akku unterstützt wird. Wenn der Akku diese Funktion nicht unterstützt, sollte der Wert leer bleiben.

Status

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen (10), DisplayName ("Status")

Zeichenfolge, die den aktuellen status des Objekts angibt. Es können operative und nicht operative status definiert werden. Operative status können "OK", "Degraded" und "Pred Fail" enthalten. "Pred Fail" gibt an, dass ein Element ordnungsgemäß funktioniert, aber einen Fehler vorhersagt (z. B. ein SMART-fähiges Festplattenlaufwerk).

Nicht betriebsbereite status können "Error", "Starting", "Stop" und "Service" enthalten. "Dienst" kann beim Spiegel des Datenträgers, beim erneuten Laden einer Benutzerberechtigungsliste oder bei anderen Administrativen Arbeiten angewendet werden. Nicht alle derartigen Arbeiten sind online, aber das verwaltete Element ist weder "OK" noch in einem der anderen Zustände.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Folgende Werte sind gültig:

OK ("OK")

Fehler ("Fehler")

Degraded ("Degraded")

Unbekannt ("Unbekannt")

Pred Fail ("Pred Fail")

Starten ("Start")

Beenden ("Beenden")

Dienst ("Dienst")

Gestresst ("Gestresst")

NonRecover ("NonRecover")

Kein Kontakt ("Kein Kontakt")

Lost Comm ("Lost Comm")

StatusInfo

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("MIF. DMTF| Betriebszustand|003.3")

Zustand des logischen Geräts. Wenn diese Eigenschaft nicht auf das logische Gerät angewendet wird, sollte der Wert 5 ("Nicht zutreffend") verwendet werden.

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

Sonstiges (1)

Unbekannt (2)

Aktiviert (3)

Deaktiviert (4)

Nicht zutreffend (5)

SystemCreationClassName

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: Weitergegeben ("CIM_System. CreationClassName"), CIM_Key

Der Name der Erstellungsklasse des Bereichssystems.

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

Systemname

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: Weitergegeben ("CIM_System. Name"), CIM_Key

Der Name des Bereichssystems.

Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

TimeOnBattery

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: Einheiten ("Sekunden")

Verstrichene Zeit in Sekunden, da die USV des Computersystems zuletzt auf Akkuleistung umgestellt wurde, oder die Zeit seit dem letzten Neustart des Systems oder der USV, je nachdem, welcher Wert kleiner ist. Der Wert 0 wird zurückgegeben, wenn der Akku "online" ist.

TimeToFullCharge

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("MIF. DMTF| Tragbarer Akku|002.16"), Einheiten ("Minuten")

Verbleibende Zeit in Minuten, um den Akku bei der aktuellen Laderate vollständig aufzuladen und zu verwenden.

Bemerkungen

Die CIM_Battery-Klasse wird von CIM_LogicalDevice abgeleitet.

WMI implementiert diese Klasse nicht. Weitere Informationen zu von CIM_Battery abgeleiteten Klassen finden Sie unter Win32-Klassen.

Diese Dokumentation wird von den CIM-Klassenbeschreibungen abgeleitet, die vom DMTF veröffentlicht werden. Microsoft hat möglicherweise Änderungen vorgenommen, um kleinere Fehler zu beheben, den Dokumentationsstandards des Microsoft SDK zu entsprechen oder weitere Informationen bereitzustellen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows Vista
Unterstützte Mindestversion (Server)
 WindowsServer 2008
Namespace
 Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Siehe auch

CIM_LogicalDevice