Freigeben über


Msvm_SyntheticMouse-Klasse

Stellt ein Synthetisches Mausgerät dar.

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

Syntax

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_SyntheticMouse : CIM_PointingDevice
{
  string   InstanceID;
  string   Caption = "Mouse";
  string   Description = "Microsoft Synthetic Mouse";
  string   ElementName = "Mouse";
  datetime InstallDate;
  string   Name = "Mouse";
  uint16   OperationalStatus[] = { 2 };
  string   StatusDescriptions[] = {
                "OK"
              };
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState = 2;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName = "Msvm_ComputerSystem";
  string   SystemName;
  string   CreationClassName = "Msvm_SyntheticMouse";
  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;
  uint16   PointingType = 3;
  uint8    NumberOfButtons = 5;
  uint16   Handedness = 2;
  uint32   Resolution;
  boolean  AbsoluteCoordinates = True;
  sint32   HorizontalPosition;
  sint32   VerticalPosition;
  sint32   ScrollPosition;
};

Member

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

Methoden

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

Methode BESCHREIBUNG
ClickButton Simuliert einen Schaltflächenklick der angegebenen Geräteschaltfläche.
EnableDevice Diese Methode wird nicht unterstützt.
GetButtonState Ruft den aktuellen Zustand der angegebenen Geräteschaltfläche ab.
OnlineGeräte Diese Methode wird nicht unterstützt.
QuiesceDevice Diese Methode wird nicht unterstützt.
RequestStateChange Fordert eine Zustandsänderung an
Zurücksetzen Setzt das Gerät zurück.
RestoreProperties Diese Methode wird nicht unterstützt.
SaveProperties Diese Methode wird nicht unterstützt.
SetAbsolutePosition Legt die horizontale und vertikale Position des Mauscursors fest.
SetButtonState Legt den aktuellen Zustand der angegebenen Geräteschaltfläche fest.
SetPowerState Diese Methode wird nicht unterstützt.
SetScrollPosition Legt die Z-Koordinate des Radsteuerelements des Zeigegeräts fest.

Eigenschaften

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

AbsoluteCoordinates

Datentyp: boolean

Zugriffstyp: Schreibgeschützt

Gibt an, ob das Gerät mit absoluten oder relativen Koordinaten arbeitet.

Wert Bedeutung
Wahr
Die Koordinaten des Geräts sind absolut.
False
Die Koordinaten des Geräts sind relativ.

Zusätzliche Verfügbarkeit

Datentyp: uint16-Array

Zugriffstyp: Schreibgeschützt

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

Wert Bedeutung
{6}
Nicht zutreffend

Verfügbarkeit

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

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

Wert Bedeutung
6
Nicht zutreffend

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 immer auf Null festgelegt.

Caption

Datentyp: string

Zugriffstyp: Schreibgeschützt

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)

Verlorene Kommunikation (3)

Kein Kontakt (4)

DMTF Reserviert (..)

Vendor Reserved (0x8000.. )

CreationClassName

Datentyp: string

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: string

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ützende Entität im Fehler (5)

DMTF Reserviert (..)

Vendor Reserved (0x8000.. )

DeviceID

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen (64)

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: string

Zugriffstyp: Schreibgeschützt

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

EnabledDefault

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

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

EnabledState

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Der aktivierte und deaktivierte Status eines Elements. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt.

Wert Bedeutung
Aktiviert
2
Der virtuelle Gastcomputer unterstützt eine synthetische Maus.
Disabled
3
Der virtuelle Gastcomputer unterstützt keine synthetische Maus.

ErrorCleared

Datentyp: boolean

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: string

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.

Händigkeit

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Die Konfiguration des Zeigegeräts für den rechten oder linken Betrieb. Diese Eigenschaft wird von CIM_PointingDevice geerbt.

Wert Bedeutung
0
Unbekannt
1
Nicht zutreffend
2
Rechtshändiger Betrieb.
3
Linkshänder-Operation.

HealthState

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Die aktuelle Integrität des Elements. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

HorizontalPosition

Datentyp: sint32

Zugriffstyp: Schreibgeschützt

Die absolute x-Koordinate des Zeigegeräts.

IdentifyingDescriptions

Datentyp: Zeichenfolgenarray

Zugriffstyp: Schreibgeschützt

Ein Array von Freiformzeichenfolgen, die Erklärungen und Details hinter den Einträgen im OtherIdentifyingInfo-Array 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: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schlüssel

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

IsLocked

Datentyp: boolean

Zugriffstyp: Schreibgeschützt

Gibt an, ob das Gerät gesperrt ist, wodurch Benutzereingaben oder -ausgaben verhindert werden. 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.

MaxQuiesceTime

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

Diese Eigenschaft ist veraltet. Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

Name

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen (1024)

Die 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.

NumberOfButtons

Datentyp: uint8

Zugriffstyp: Schreibgeschützt

Die Anzahl der Schaltflächen auf dem zeigenden Gerät. Diese Eigenschaft wird von CIM_PointingDevice geerbt.

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)

In Test (14)

Übergang (15)

Im Dienst (16)

DMTF Reserviert (..)

Vendor Reserved (0x8000.. )

OperationalStatus

Datentyp: uint16-Array

Zugriffstyp: Schreibgeschützt

Die aktuelle status des Elements. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

OtherEnabledState

Datentyp: string

Zugriffstyp: Schreibgeschützt

Der aktivierte oder deaktivierte Status des Elements, wenn die EnabledState-Eigenschaft auf 1 (Sonstige) festgelegt ist. Diese Eigenschaft muss auf NULL festgelegt werden, wenn EnabledState einen anderen Wert als 1 aufweist. 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önnen, um ein logisches Gerät zu identifizieren. Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

PointingType

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Der Typ des Zeigegeräts. Diese Eigenschaft wird von CIM_PointingDevice geerbt.

Wert Bedeutung
3
Maus

PowerManagementCapabilities

Datentyp: uint16-Array

Zugriffstyp: Schreibgeschützt

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

PowerManagementSupported

Datentyp: boolean

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)

Beeinträchtigt (2)

Fehler (3)

DMTF Reserviert (..)

Vendor Reserved (0x8000.. )

RequestedState

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Der letzte angeforderte oder gewünschte Zustand für das Element. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt.

Wert Bedeutung
12
Nicht zutreffend

Lösung

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Die Nachverfolgungsauflösung des zeigenden Geräts in Anzahl pro Zoll. Diese Eigenschaft wird von CIM_PointingDevice geerbt.

ScrollPosition

Datentyp: sint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: Einheiten ("Mickeys")

Die Position der Z-Koordinate des Mausgeräts.

Status

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Die aktuelle status des -Objekts. 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.

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: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen (256)

Der Name der Erstellungsklasse des Bereichssystems. Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

Systemname

Datentyp: Zeichenfolge

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 oder die Uhrzeit, zu dem sich der aktivierte Status des Elements zuletzt geändert hat. Wenn sich der Zustand des Elements nicht geändert hat und diese Eigenschaft aufgefüllt wird, muss sie 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 ist immer auf NULL festgelegt.

TotalPowerOnHours

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

Die Gesamtzahl der Stunden, die dieses Gerät mit Strom versorgt hat. 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 ist immer auf NULL festgelegt.

VerticalPosition

Datentyp: sint32

Zugriffstyp: Schreibgeschützt

Die absolute y-Koordinate des zeigenden Geräts.

Bemerkungen

Der Zugriff auf die Msvm_SyntheticMouse-Klasse kann durch die 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
Stamm\Virtualization\V2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

Siehe auch

CIM_PointingDevice

CIM_PointingDevice

Eingabeklassen