CIM_LogicalDevice-Klasse (CIMWin32-WMI-Anbieter)

Die CIM _ LogicalDevice-Klasse stellt eine Hardwareentität dar, die in physischer Hardware realisiert werden kann oder nicht.

Wichtig

Die CIM-Klassen (Distributed Management Task Force) (DMTF (Distributed Management Task Force) (Common Information Model) 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("{8502C529-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class CIM_LogicalDevice : CIM_LogicalElement
{
  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;
};

Member

Die CIM _ LogicalDevice-Klasse verfügt über folgende Typen von Membern:

Methoden

Die CIM _ LogicalDevice-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 ein Gerät in diesen Zustand versetzt werden soll. Nicht von WMI implementiert.

Eigenschaften

Die CIM _ LogicalDevice-Klasse verfügt über diese Eigenschaften.

Verfügbarkeit

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

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

Verfügbarkeit und Status des Geräts.

Andere (1)

Unbekannt (2)

Running/Full Power (3) (Ausführen/Vollbetrieb (3))

Warnung (4)

In Test (5)

Nicht zutreffend (6)

Ausschalten (7)

Off Line (8)

Off-Duty (9)

Heruntergestuft (10)

Nicht installiert (11)

Installationsfehler (12)

Energiesparen – Unbekannt (13)

Das Gerät befindet sich bekanntermaßen im Energiesparmodus, aber sein genauer Status ist unbekannt.

Energiesparmodus – Energiesparmodus (14)

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

Energiesparmodus – Standby (15)

Das Gerät funktioniert nicht, kann aber schnell voll ausgepowert werden.

Stromzyklus (16)

Energiesparen – Warnung (17)

Das Gerät befindet sich in einem Warnungszustand, 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.

Still (21)

Das Gerät ist still.

Caption

Datentyp: string

Zugriffstyp: Schreibgeschützt

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

Eine kurze Textbeschreibung des Objekts.

Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt.

ConfigManagerErrorCode

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schema ("Win32")

Win32 Konfigurations-Manager Fehlercode.

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 ü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 können. (5)

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

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)

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

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

Windows können die Ressourcen dieses Geräts nicht überprüfen. (13)

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

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

Windows können nicht alle Ressourcen identifizieren, die dieses Gerät verwendet. (16)

Dieses Gerät fordert einen unbekannten Ressourcentyp an. (17)

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

Fehler beim Verwenden des VxD-Ladeprogramm. (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, finden Sie weitere Informationen in der 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, finden Sie weitere Informationen in der Hardwaredokumentation. (23)

Dieses Gerät ist nicht vorhanden, funktioniert nicht ordnungsgemäß oder verfügt nicht über alle installierten Treiber. (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 ihm nicht die erforderlichen Ressourcen bereitgestellt hat. (29)

Dieses Gerät verwendet eine IRQ-Ressource (Interrupt Request), 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 können. (31)

ConfigManagerUserConfig

Datentyp: boolescher Wert

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schema ("Win32")

True gibt an, dass das Gerät eine benutzerdefinierte Konfiguration verwendet.

CreationClassName

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: _ CIM-Schlüssel

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

Beschreibung

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("Beschreibung")

Eine Textbeschreibung des Objekts.

Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt.

Deviceid

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: _ CIM-Schlüssel

Adresse oder andere identifizierende Informationen, um dem logischen Gerät einen eindeutigen Namen zu geben.

ErrorCleared

Datentyp: boolescher Wert

Zugriffstyp: Schreibgeschützt

True gibt an, dass der in der LastErrorCode-Eigenschaft gemeldete Fehler jetzt gelöscht wird.

ErrorDescription

Datentyp: string

Zugriffstyp: Schreibgeschützt

Eine Freiformzeichenfolge, die Informationen über den in der LastErrorCode-Eigenschaft aufgezeichneten Fehler und die auszuführenden Korrekturmaßnahmen enthält.

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 _ ManagedSystemElementgeerbt.

LastErrorCode

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Der letzte vom logischen Gerät gemeldete Fehlercode.

Name

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("Name")

Bezeichnung, mit der das Objekt bekannt ist. Bei Einer Unterklasse kann diese Eigenschaft als Schlüsseleigenschaft überschrieben werden.

Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt.

PNPDeviceID

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schema ("Win32")

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

Beispiel: * "PNP030b"

PowerManagementCapabilities

Datentyp: uint16-Array

Zugriffstyp: Schreibgeschützt

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

Unbekannt (0)

Die energiebezogenen 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 Energieverwaltungsfunktionen sind derzeit aktiviert, aber der genaue Featuresatz ist unbekannt, oder die Informationen sind nicht verfügbar.

Automatisch eingegebene Energiesparmodi (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 Managed Object Format -Klassen (MOF).

Power-Bike 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 Ein-/Aus-Setzen festgelegt ist.

PowerManagementSupported

Datentyp: boolescher Wert

Zugriffstyp: Schreibgeschützt

If TRUE, the device can be power managed, that is, put into a power-save state. False gibt an, dass der ganzzahlige Wert 1 ("Nicht unterstützt") der einzige Eintrag im PowerManagementCapabilities-Array sein sollte.

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

Status

Datentyp: string

Zugriffstyp: Schreibgeschützt

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

Eine Zeichenfolge, die den aktuellen Status des Objekts angibt. Betriebsstatus und nicht betriebsbereiter Status können definiert werden. Der Betriebsstatus kann "OK", "Heruntergestuft" und "Fehler vor dem Ausfall" enthalten. "Pred Fail" gibt an, dass ein Element ordnungsgemäß funktioniert, aber einen Fehler vorhersagt (z. B. eine SMART-fähige Festplatte).

Nicht betriebsbereite Status können "Error", "Starting", "Stopping" und "Service" sein. "Dienst" kann während der Spiegelung des Datenträgers, beim erneuten Laden einer Benutzerberechtigungsliste oder bei anderen administrativen Aufgaben angewendet werden. Nicht alle diese 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")

Heruntergestuft ("Heruntergestuft")

Unbekannt ("Unbekannt")

Pred Fail ("Pred Fail")

Wird gestartet ("Wird gestartet")

Wird beendet ("Wird beendet")

Dienst ("Dienst")

Striche ("Strich")

NonRecover ("NonRecover")

Kein Kontakt ("Kein Kontakt")

Lost Comm ("Lost Comm")

StatusInfo

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("MIF. DMTF | Operational State | 003.3")

Status des logischen Geräts. Wenn diese Eigenschaft nicht für das logische Gerät gilt, sollte der Wert 5 ("Nicht zutreffend") verwendet werden.

Sonstige (1)

Unbekannt (2)

Aktiviert (3)

Deaktiviert (4)

Nicht zutreffend (5)

SystemCreationClassName

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: Propagated ("_ CIM-System.CreationClassName"), _ CIM-Schlüssel

Der Name der Erstellungsklasse des Bereichssystems.

Systemname

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: Propagated ("_ CIM-System.Name"), _ CIM-Schlüssel

Der Name des Bereichssystems.

Hinweise

Merkmale logischer Geräte, die den Vorgang oder die Konfiguration verwalten, sind im CIM _ LogicalDevice-Objekt enthalten oder diesem zugeordnet. Betriebseigenschaften des Druckers sind z. B. unterstützte Papiergrößen oder erkannte Fehler. Konfigurationseigenschaften für Sensorgeräte sind z. B. Schwellenwerteinstellungen. Für ein logisches Gerät können verschiedene Konfigurationen vorhanden sein und sind in den _ CIM-Einstellungsobjekten enthalten, die dem logischen Gerät zugeordnet sind.

Die CIM _ LogicalDevice-Klasse wird von CIM _ LogicalElement abgeleitet.

WMI implementiert diese Klasse nicht. Informationen zu Klassen, die von CIM _ LogicalDevice abgeleitet werden, finden Sie unter Win32-Klassen.

Diese Dokumentation wird von den CIM-Klassenbeschreibungen abgeleitet, die von DMTF veröffentlicht wurden. Microsoft hat möglicherweise Änderungen vorgenommen, um kleinere Fehler zu beheben, die Dokumentationsstandards des Microsoft SDK zu erfüllen oder weitere Informationen zur Verfügung zu stellen.

Anforderungen

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

Weitere Informationen

CIM _ LogicalElement