Freigeben über


Msvm_GuestServiceInterfaceComponent-Klasse

Stellt den Zustand der Gastdienstschnittstellenkomponente dar, die einen Mechanismus für die Interaktion mit dem virtuellen Computer über die Verwaltungsschnittstellen auf dem Hostsystem bereitstellt. Diese Klasse wird von der CIM_LogicalDevice-Klasse abgeleitet.

Die folgende Syntax enthält vereinfachten MOF-Code und schließt alle geerbten Eigenschaften ein.

Syntax

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_GuestServiceInterfaceComponent : CIM_LogicalDevice
{
  uint16   Availability;
  string   Caption;
  uint32   ConfigManagerErrorCode;
  boolean  ConfigManagerUserConfig;
  string   CreationClassName;
  string   Description;
  string   DeviceID;
  boolean  ErrorCleared;
  string   ErrorDescription;
  datetime InstallDate;
  uint32   LastErrorCode;
  string   Name;
  string   PNPDeviceID;
  uint16   PowerManagementCapabilities[];
  boolean  PowerManagementSupported;
  string   Status;
  uint16   StatusInfo;
  string   SystemCreationClassName;
  string   SystemName;
};

Member

Die Msvm_GuestServiceInterfaceComponent-Klasse verfügt über folgende Membertypen:

Methoden

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

Methode Beschreibung
RequestStateChange Fordert an, dass der Status der Gastdienstschnittstellenkomponente in den angegebenen Wert geändert wird.
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 Msvm_GuestServiceInterfaceComponent-Klasse verfügt über diese Eigenschaften.

Verfügbarkeit

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Verfügbarkeit und status des Geräts.

Wert Bedeutung
Andere
1 (0x1)
Unbekannt
2 (0x2)
Running/Full Power
3 (0x3)
Warnung
4 (0x4)
Wird getestet
5 (0x5)
Nicht verfügbar
6 (0x6)
Ausschalten
7 (0x7)
Off Line
8 (0x8)
Off Duty
9 (0x9)
Beeinträchtigt
10 (0xA)
Nicht installiert
11 (0xB)
Installationsfehler
12 (0xC)
Stromsparen – Unbekannt
13 (0xD)
Es ist bekannt, dass sich das Gerät in einem Energiesparmodus befindet, aber seine genaue status ist unbekannt.
Stromsparmodus
14 (0xE)
Das Gerät befindet sich im Energiesparmodus, funktioniert aber weiterhin und kann eine leistungseinbußen aufweisen.
Stromsparen – Standby
15 (0xF)
Das Gerät funktioniert nicht, konnte aber schnell auf volle Leistung gebracht werden.
Ein/Aus-/Ausschaltzyklus
16 (0x10)
Stromsparen – Warnung
17 (0x11)
Das Gerät befindet sich in einem Warnzustand, aber auch im Energiesparmodus.

Caption

Datentyp: string

Zugriffstyp: Schreibgeschützt

Kurze Textbeschreibung des Objekts. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

ConfigManagerErrorCode

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Win32 Configuration Manager Fehlercode.

Wert Bedeutung
0 (0x0)
Das Gerät funktioniert ordnungsgemäß.
1 (0x1)
Das Gerät ist nicht ordnungsgemäß konfiguriert.
2 (0x2)
Windows kann den Treiber für dieses Gerät nicht laden.
3 (0x3)
Der Treiber für dieses Gerät ist möglicherweise beschädigt, oder das System verfügt über wenig Arbeitsspeicher oder andere Ressourcen.
4 (0x4)
Das Gerät funktioniert nicht ordnungsgemäß. Einer der Treiber oder die Registrierung ist möglicherweise beschädigt.
5 (0x5)
Der Treiber für das Gerät erfordert eine Ressource, die Windows nicht verwalten kann.
6 (0x6)
Die Startkonfiguration für das Gerät ist in Konflikt mit anderen Geräten.
7 (0x7)
Filter kann nicht gefiltert werden.
8 (0x8)
Das Treiberladeprogramm für das Gerät fehlt.
9 (0x9)
Das Gerät funktioniert nicht ordnungsgemäß. Die steuernde Firmware meldet die Ressourcen für das Gerät fälschlicherweise.
10 (0xA)
Das Gerät kann nicht gestartet werden.
11 (0xB)
Fehler beim Gerät.
12 (0xC)
Das Gerät kann nicht genügend kostenlose Ressourcen finden, um es zu verwenden.
13 (0xD)
Windows kann die Ressourcen des Geräts nicht überprüfen.
14 (0xE)
Das Gerät kann erst dann ordnungsgemäß funktionieren, wenn der Computer neu gestartet wird.
15 (0xF)
Das Gerät funktioniert aufgrund eines möglichen Problems mit einer erneuten Enumeration nicht ordnungsgemäß.
16 (0x10)
Windows kann nicht alle Ressourcen identifizieren, die vom Gerät verwendet werden.
17 (0x11)
Das Gerät fordert einen unbekannten Ressourcentyp an.
18 (0x12)
Gerätetreiber müssen neu installiert werden.
19 (0x13)
Fehler beim Verwenden des VxD-Ladeprogramms.
20 (0x14)
Die Registrierung ist möglicherweise beschädigt.
21 (0x15)
Systemfehler. Wenn das Ändern des Gerätetreibers ineffektiv ist, lesen Sie die Hardwaredokumentation. Windows entfernt das Gerät.
22 (0x16)
Das Gerät ist deaktiviert.
23 (0x17)
Systemfehler. Wenn das Ändern des Gerätetreibers ineffektiv ist, lesen Sie die Hardwaredokumentation.
24 (0x18)
Das Gerät ist nicht vorhanden, funktioniert nicht ordnungsgemäß, oder es sind nicht alle Treiber installiert.
25 (0x19)
Windows richtet das Gerät noch ein.
26 (0x1A)
Windows richtet das Gerät noch ein.
27 (0x1B)
Das Gerät verfügt nicht über eine gültige Protokollkonfiguration.
28 (0x1C)
Gerätetreiber sind nicht installiert.
29 (0x1D)
Das Gerät ist deaktiviert; Die Gerätefirmware hat nicht die erforderlichen Ressourcen bereitgestellt.
30 (0x1E)
Das Gerät verwendet eine IRQ-Ressource, die von einem anderen Gerät verwendet wird.
31 (0x1F)
Das Gerät funktioniert nicht ordnungsgemäß. Windows kann die erforderlichen Gerätetreiber nicht laden.

ConfigManagerUserConfig

Datentyp: boolean

Zugriffstyp: Schreibgeschützt

Bei TRUE verwendet das Gerät eine benutzerdefinierte Konfiguration.

CreationClassName

Datentyp: string

Zugriffstyp: Schreibgeschützt

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.

Beschreibung

Datentyp: string

Zugriffstyp: Schreibgeschützt

Textbeschreibung des Objekts. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

DeviceID

Datentyp: string

Zugriffstyp: Schreibgeschützt

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

ErrorCleared

Datentyp: boolean

Zugriffstyp: Schreibgeschützt

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

ErrorDescription

Datentyp: string

Zugriffstyp: Schreibgeschützt

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

InstallDate

Datentyp: datetime

Zugriffstyp: Schreibgeschützt

Datum und Uhrzeit der Installation des Objekts. Diese Eigenschaft benötigt keinen Wert, um anzugeben, dass das Objekt installiert ist. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

LastErrorCode

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

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

Name

Datentyp: string

Zugriffstyp: Schreibgeschützt

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

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

Beispiel: "*PNP030b"

PowerManagementCapabilities

Datentyp: uint16-Array

Zugriffstyp: Schreibgeschützt

Array der spezifischen energiebezogenen Funktionen eines logischen Geräts. Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

Wert Bedeutung
Unbekannt
0 (0x0)
Nicht unterstützt
1 (0x1)
Disabled
2 (0x2)
Aktiviert
3 (0x3)
Die Energieverwaltungsfeatures sind derzeit aktiviert, aber der genaue Featuresatz ist unbekannt, oder die Informationen sind nicht verfügbar.
Energiesparmodi, die automatisch eingegeben werden
4 (0x4)
Das Gerät kann seinen Energiezustand basierend auf der Nutzung oder anderen Kriterien ändern.
Power State Settable
5 (0x5)
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 (0x6)
Die SetPowerState-Methode kann aufgerufen werden, wenn der PowerState-Parameter auf 5 ("Power Cycle") festgelegt ist.
Timed Power On Wird unterstützt
7 (0x7)
Die SetPowerState-Methode kann aufgerufen werden, wenn der PowerState-Parameterauf 5 ("Power Cycle") und Time 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 .

Status

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Aktuelle status des Objekts. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Folgende Werte sind gültig:

"OK"

"Fehler"

"Degraded"

"Unbekannt"

"Pred Fail"

"Start"

"Beenden"

"Dienst"

"Gestresst"

"NonRecover"

"Kein Kontakt"

"Lost Comm"

StatusInfo

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

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.

Sonstige (1 (0x1))

Unbekannt (2 (0x2))

Aktiviert (3 (0x3))

Deaktiviert (4 (0x4))

Nicht zutreffend (5 (0x5))

SystemCreationClassName

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Der Name der Erstellungsklasse des Bereichssystems.

Systemname

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Der Name des Bereichssystems.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 8.1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Server 2012 R2 [nur Desktop-Apps]
Namespace
Stamm\Virtualization\V2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

Siehe auch

CIM_LogicalDevice

CIM_LogicalDevice