Msvm_Keyboard-Klasse

Artikel
06/13/2023

Stellt ein Tastaturgerät dar. Tastaturen sind logische Geräte, die immer in einem virtuellen Computer vorhanden sind und daher nicht über einen Ressourcenpool zugeordnet werden. Ein instance ist in einem virtuellen Computersystem immer vorhanden.

Die folgende Syntax ist vereinfachter MOF-Code (Managed Object Format) und enthält alle geerbten Eigenschaften.

Syntax

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_Keyboard : CIM_UserDevice
{
  string   InstanceID;
  string   Caption = "Keyboard";
  string   Description = "Microsoft Virtual Keyboard";
  string   ElementName = "Keyboard";
  datetime InstallDate;
  string   Name = "Keyboard";
  uint16   OperationalStatus[] = { 2 };
  string   StatusDescriptions[] = { "OK" };
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState = 5;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName = "Msvm_ComputerSystem";
  string   SystemName;
  string   CreationClassName = "Msvm_Keyboard";
  string   DeviceID;
  boolean  PowerManagementSupported;
  uint16   PowerManagementCapabilities[];
  uint16   Availability = 6;
  uint16   StatusInfo;
  uint32   LastErrorCode;
  string   ErrorDescription;
  boolean  ErrorCleared;
  string   OtherIdentifyingInfo[];
  uint64   PowerOnHours;
  uint64   TotalPowerOnHours;
  string   IdentifyingDescriptions[];
  uint16   AdditionalAvailability[] = { 6 };
  uint64   MaxQuiesceTime;
  boolean  IsLocked = False;
  string   Layout = "00000409";
  uint16   NumberOfFunctionKeys = 12;
  uint16   Password = 5;
  boolean  UnicodeSupported;
};

Member

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

Methoden
Eigenschaften

Methoden

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

Methode	BESCHREIBUNG
EnableDevice	Diese Methode wird nicht unterstützt.
IsKeyPressed	Ruft den Schlüsselstatus eines Schlüssels ab.
OnlineGeräte	Diese Methode wird nicht unterstützt.
PressKey	Simuliert einen Tastendruck.
QuiesceDevice	Diese Methode wird nicht unterstützt.
ReleaseKey	Simuliert eine Schlüsselfreigabe.
RequestStateChange	Fordert an, dass der Zustand des Elements geändert wird.
Zurücksetzen	Setzt die virtuelle Tastatur zurück.
RestoreProperties	Diese Methode wird nicht unterstützt.
SaveProperties	Diese Methode wird nicht unterstützt.
SetPowerState	Diese Methode wird nicht unterstützt.
TypeCtrlAltDel	Simuliert eine TASTENSEQUENZ MIT STRG+ALT+ENTF.
TypeKey	Simuliert eine Tastensequenz der Pressemitteilung.
TypeScancodes	Simuliert eine Schlüsselsequenz mithilfe von Scancodes.
Typetext	Simuliert eine Reihe von typisierten Zeichen.

Eigenschaften

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

ZusätzlicheVerfügbarkeit

Datentyp: uint16-Array
Zugriffstyp: Schreibgeschützt

Alle zusätzlichen Verfügbarkeiten und status des Geräts, die über die in der Availability-Eigenschaft angegebenen hinausgehen. Die Availability-Eigenschaft gibt den primären status und die Verfügbarkeit des Geräts an. Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

Verfügbarkeit

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Die primäre Verfügbarkeit und status des Geräts. Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

AvailableRequestedStates

Datentyp: uint16-Array
Zugriffstyp: Schreibgeschützt

Gibt die möglichen Werte für den RequestedState-Parameter der RequestStateChange-Methode an. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt und ist immer auf NULL festgelegt.

Caption

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifizierer: MaxLen (64)

Eine kurze Beschreibung des Objekts. Diese Eigenschaft wird von CIM_ManagedElement geerbt.

CommunicationStatus

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Gibt die Fähigkeit der Instrumentierung an, mit dem zugrunde liegenden verwalteten Element zu kommunizieren. Ein Null-Wert gibt an, dass diese Eigenschaft nicht implementiert ist. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Unbekannt (0)
Nicht verfügbar (1)
Kommunikation OK (2)
Kommunikation verloren (3)
Kein Kontakt (4)
DMTF Reserviert (..)
Vendor Reserved (0x8000.. )

CreationClassName

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifizierer: MaxLen (256)

Der Name der Klasse oder Unterklasse, die bei der Erstellung eines 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: Zeichenfolge
Zugriffstyp: Schreibgeschützt

Eine Beschreibung des -Objekts. Diese Eigenschaft wird von CIM_ManagedElement geerbt.

DetailedStatus

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Ergänzt die PrimaryStatus-Eigenschaft mit zusätzlichen status Details. Ein Null-Wert gibt an, dass diese Eigenschaft nicht implementiert ist. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Nicht verfügbar (0)
Keine zusätzlichen Informationen (1)
Gestresst (2)
Vorhersagefehler (3)
Nicht wiederherstellbarer Fehler (4)
Unterstützen von Entitäten im Fehler (5)
DMTF Reserviert (..)
Vendor Reserved (0x8000.. )

DeviceID

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

Eine Adresse oder andere identifizierende Informationen, um das logische Gerät eindeutig zu benennen. Diese Eigenschaft wird von CIM_LogicalDevice geerbt und ist immer auf "Microsoft:GUID" festgelegt.

ElementName

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

Ein Anzeigename für das Objekt. Mit dieser Eigenschaft kann jeder instance zusätzlich zu den Schlüsseleigenschaften, Identitätsdaten und Beschreibungsinformationen einen Anzeigenamen definieren. Die Name-Eigenschaft der CIM_ManagedSystemElement-Klasse wird auch als Anzeigename definiert. Sie wird jedoch häufig als Schlüssel unterklassiert. Es ist nicht sinnvoll, dass dieselbe Eigenschaft sowohl identitäts- als auch anzeigename ohne Inkonsistenzen vermitteln kann. Wenn Name vorhanden ist und kein Schlüssel ist (z. B. für Instanzen von CIM_LogicalDevice), können dieselben Informationen sowohl in der Name - als auch in der ElementName-Eigenschaft vorhanden sein. Diese Eigenschaft wird von CIM_ManagedElement geerbt.

EnabledDefault

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Die Standard- oder Startkonfiguration eines Administrators für den aktivierten Status eines Elements. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt.

Wert	Bedeutung
2	Aktiviert

EnabledState

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Gibt die aktivierten und deaktivierten Zustände eines Elements an. Es kann auch die Übergänge zwischen diesen angeforderten Zuständen angeben. Das Herunterfahren (wert=4) und das Starten (wert=10) sind beispielsweise vorübergehende Zustände zwischen aktiviert und deaktiviert.

Wert	Bedeutung
Unbekannt 0	Unbekannt
Andere 1	Sonstiges
Aktiviert 2	Das Element ist oder kann Befehle ausführen, verarbeitet alle Befehle in der Warteschlange und stellt neue Anforderungen in die Warteschlange.
Disabled 3	Das Element führt keine Befehle aus und löscht alle neuen Anforderungen.
Herunterfahren 4	Das Element wechselt gerade in den Status Deaktiviert.
Nicht verfügbar 5	Das Element unterstützt keine Aktivierung oder Deaktivierung.
Aktiviert, aber offline 6	Das Element schließt möglicherweise Befehle ab und löscht alle neuen Anforderungen.
Wird getestet 7	Das Element befindet sich in einem Testzustand.
Latent 8	Das Element kann Befehle abschließen, aber es werden alle neuen Anforderungen in die Warteschlange gestellt.
Stilllegen 9	Das Element ist aktiviert, aber in einem eingeschränkten Modus. Das Verhalten des Elements ähnelt dem Status Aktiviert (2), verarbeitet aber nur einen eingeschränkten Satz von Befehlen. Alle anderen Anforderungen werden in die Warteschlange gestellt.
Wird gestartet 10	Das Element wechselt gerade in den Status Aktiviert (2). Neue Anforderungen werden in die Warteschlange gestellt.
DMTF Reserviert 11 32767	Dieser Wert ist reserviert.
Anbieter reserviert 32768 65535	Dieser Wert ist reserviert.

ErrorCleared

Datentyp: Boolesch
Zugriffstyp: Schreibgeschützt

Gibt an, ob der in LastErrorCode gemeldete Fehler jetzt gelöscht wird. Diese Eigenschaft wird von CIM_LogicalDevice geerbt, aber nicht verwendet.

ErrorDescription

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

Eine Zeichenfolge, die weitere Informationen zu dem in LastErrorCode aufgezeichneten Fehler und Informationen zu möglichen Korrekturmaßnahmen bereitstellt. Diese Eigenschaft wird von CIM_LogicalDevice geerbt, aber nicht verwendet.

HealthState

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Die aktuelle Integrität des Elements. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt und ist immer auf 5 (OK) festgelegt.

IdentifyingDescriptions

Datentyp: Zeichenfolgenarray
Zugriffstyp: Schreibgeschützt

Ein Array von Freiformzeichenfolgen, die Erklärungen und Details hinter den Einträgen im Array OtherIdentifyingInfo bereitstellen. Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

InstallDate

Datentyp: datetime
Zugriffstyp: Schreibgeschützt

Das Datum und die Uhrzeit der Erstellung des virtuellen Computers. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

InstanceID

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifizierer: Schlüssel

Identifiziert eindeutig einen instance dieser Klasse. Diese Eigenschaft wird von CIM_ManagedElement geerbt.

IsLocked

Datentyp: Boolesch
Zugriffstyp: Schreibgeschützt

Gibt an, ob das Gerät gesperrt ist, wodurch die Benutzereingabe oder -ausgabe verhindert wird. Diese Eigenschaft wird von CIM_UserDevice geerbt.

LastErrorCode

Datentyp: uint32
Zugriffstyp: Schreibgeschützt

Der letzte Fehlercode, der vom logischen Gerät gemeldet wurde. Diese Eigenschaft wird von CIM_LogicalDevice geerbt, aber nicht verwendet.

Layout

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

Eine Zeichenfolge, die das Format und das Layout der Tastatur angibt.

MaxQuiesceTime

Datentyp: uint64
Zugriffstyp: Schreibgeschützt

Diese Eigenschaft ist veraltet. Diese Eigenschaft wird von CIM_LogicalDevice geerbt, aber nicht verwendet.

Name

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifizierer: MaxLen (1024)

Die Bezeichnung, unter der das Objekt bekannt ist. Wenn sie unterklassiert wird, kann diese Eigenschaft als Schlüsseleigenschaft überschrieben werden. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

NumberOfFunctionKeys

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Die Anzahl der Funktionstasten auf der Tastatur.

OperatingStatus

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Stellt aktuelle status Informationen für den Betriebszustand des Elements bereit und kann verwendet werden, um weitere Details in Bezug auf den Wert der EnabledState-Eigenschaft bereitzustellen. Ein Null-Wert gibt an, dass diese Eigenschaft nicht implementiert ist. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Unbekannt (0)
Nicht verfügbar (1)
Wartung (2)
Ab (3)
Beenden (4)
Beendet (5)
Abgebrochen (6)
Ruhend (7)
Abgeschlossen (8)
Migrieren (9)
Auswandern (10)
Immigrieren (11)
Momentaufnahme (12)
Herunterfahren (13)
Im Test (14)
Übergang (15)
Im Dienst (16)
DMTF Reserviert (..)
Vendor Reserved (0x8000.. )

OperationalStatus

Datentyp: uint16-Array
Zugriffstyp: Schreibgeschützt

Der aktuelle status des Elements. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt und ist immer auf 2 (OK) festgelegt.

OtherEnabledState

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

Eine Zeichenfolge, die den aktivierten oder deaktivierten Zustand des Elements beschreibt, wenn die EnabledState-Eigenschaft auf 1 (Sonstige) festgelegt ist. Diese Eigenschaft muss auf NULL festgelegt werden, wenn EnabledState ein anderer Wert als 1 ist. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt.

OtherIdentifyingInfo

Datentyp: Zeichenfolgenarray
Zugriffstyp: Schreibgeschützt

Alle zusätzlichen Daten, die über Geräte-ID-Informationen hinaus verwendet werden könnten, um ein logisches Gerät zu identifizieren. Diese Eigenschaft wird von CIM_LogicalDevice geerbt und immer auf NULL festgelegt.

Kennwort

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Gibt an, ob ein Kennwort auf Hardwareebene auf der Tastatur aktiviert ist, wodurch lokale Eingaben verhindert werden.

5

Nicht implementiert.

PowerManagementCapabilities

Datentyp: uint16-Array
Zugriffstyp: Schreibgeschützt

Die Energieverwaltungsfunktionen des Geräts. Diese Eigenschaft wird von CIM_LogicalDevice geerbt, aber nicht verwendet.

PowerManagementSupported

Datentyp: Boolesch
Zugriffstyp: Schreibgeschützt

Gibt an, ob das Gerät energieverwaltet werden kann. Diese Eigenschaft wird von CIM_LogicalDevice geerbt, aber nicht verwendet.

PowerOnHours

Datentyp: uint64
Zugriffstyp: Schreibgeschützt

Die Anzahl der aufeinanderfolgenden Stunden, die dieses Gerät seit dem letzten Einschalten eingeschaltet wurde. Diese Eigenschaft wird von CIM_LogicalDevice geerbt, aber nicht verwendet.

PrimaryStatus

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Stellt allgemeine status Informationen bereit. Diese Eigenschaft sollte in Verbindung mit der DetailedStatus-Eigenschaft verwendet werden, um eine allgemeine und detaillierte Integrität status des Elements und seiner Unterkomponenten bereitzustellen. Ein Null-Wert gibt an, dass diese Eigenschaft nicht implementiert ist. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Unbekannt (0)
OK (1)
Herabgestuft (2)
Fehler (3)
DMTF Reserviert (..)
Vendor Reserved (0x8000.. )

RequestedState

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Der letzte angeforderte Zustand für das Element.

Wert	Bedeutung
Nicht verfügbar 12	Nicht zutreffend

Status

Datentyp: string
Zugriffstyp: Schreibgeschützt

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt, aber nicht verwendet.

StatusBeschreibungen

Datentyp: Zeichenfolgenarray
Zugriffstyp: Schreibgeschützt

Zeichenfolgen, die die verschiedenen OperationalStatus-Arraywerte beschreiben. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt und ist immer auf "OK" festgelegt.

StatusInfo

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Der aktuelle Zustand des logischen Geräts. Diese Eigenschaft wird von CIM_LogicalDevice geerbt, aber nicht verwendet.

SystemCreationClassName

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: MaxLen (256)

Der Name der Erstellungsklasse des Bereichssystems. Diese Eigenschaft wird von CIM_LogicalDevice geerbt und auf "Msvm_ComputerSystem" festgelegt.

Systemname

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: MaxLen (256)

Der Name des Bereichssystems. Dieser Wert entspricht dem Wert der Name-Eigenschaft der Msvm_ComputerSystem-Klasse für den bereichsbasierten virtuellen Computer. Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

TimeOfLastStateChange

Datentyp: datetime
Zugriffstyp: Schreibgeschützt

Das Datum und die Uhrzeit der letzten Änderung des aktivierten Zustands des Elements. Wenn sich der Zustand des Elements nicht geändert hat und diese Eigenschaft aufgefüllt wird, muss er auf einen 0-Intervallwert festgelegt werden. Wenn eine Zustandsänderung angefordert, aber abgelehnt oder noch nicht verarbeitet wurde, darf die Eigenschaft nicht aktualisiert werden. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt und immer auf Null festgelegt.

TotalPowerOnHours

Datentyp: uint64
Zugriffstyp: Schreibgeschützt

Die Gesamtzahl der Stunden, in denen dieses Gerät eingeschaltet wurde. Diese Eigenschaft wird von CIM_LogicalDevice geerbt, aber nicht verwendet.

TransitioningToState

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Gibt den Zielzustand an, in den die instance übergehen. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt und immer auf Null festgelegt.

UnicodeSupported

Datentyp: boolean
Zugriffstyp: Schreibgeschützt

Gibt an, ob die virtuelle Tastatur Unicode-Zeichen unterstützt. Dies kann einer der folgenden Werte sein.

Wert	Bedeutung
True	Die virtuelle Tastatur unterstützt Unicode-Zeichen.
False	Die virtuelle Tastatur unterstützt keine Unicode-Zeichen.

Bemerkungen

Der Zugriff auf die Msvm_Keyboard-Klasse kann durch UAC-Filterung eingeschränkt werden. Weitere Informationen finden Sie unter Benutzerkontensteuerung und WMI.

Anforderungen

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

Freigeben über