WMI-Eigenschaftsqualifizierer
In der folgenden Tabelle sind die erforderlichen und optionalen MOF-Eigenschaftsqualifizierer aufgeführt, die zum Definieren von Elementen in einem WMI-Daten- oder Ereignisblock verwendet werden können.
Es folgen standard-MOF-Qualifizierer: Schlüssel, Lesen, Schreiben, ValueMap und Werte. Weitere Informationen zu diesen und anderen MoF-Standardqualifizierern finden Sie unter MOF-Datentypen.
Qualifizierer | Beschreibung |
---|---|
key |
Gibt an, dass das Datenelement eine Schlüsseleigenschaft ist, die jede Instanz der Klasse eindeutig identifiziert. Nur die InstanceName-Eigenschaft kann als Schlüssel deklariert werden. |
read |
Gibt an, dass ein WMI-Client das Datenelement lesen kann. |
write |
Gibt an, dass ein WMI-Client das Datenelement festlegen kann. |
Bitmap |
Gibt die Bitpositionen der entsprechenden Zeichenfolgenwerte an, die in BitValues angegeben sind. |
BitWerte |
Gibt eine Liste von Zeichenfolgenwerten (Flagnamen) an, die Bits darstellen, die im Datenelement festgelegt sind. Die Bitposition eines Flags wird durch die in BitMap angegebene entsprechende Position definiert. |
DefineValues |
Gibt eine aufgezählte Liste an, die von der WMI-Toolsuite in eine entsprechende Liste mit #define Anweisungen kompiliert wird. |
DisplayInHex |
Gibt an, dass jeder WMI-Client, der den Eigenschaftswert anzeigt, dies in hexadezimaler Weise tun soll. |
DisplayName("string") |
Gibt eine Beschriftung an, die ein WMI-Client zum Anzeigen als Eigenschaftennamen verwenden kann. |
MaxLen(uint) |
Bei Zeichenfolgeneigenschaften gibt MaxLen die maximale Länge der Zeichenfolge in Zeichen an. Der Uint-Wert kann eine beliebige 32-Bit-ganzzahl ohne Vorzeichen sein. Wenn MaxLen weggelassen wird oder "uint " null ist, ist die Länge der Zeichenfolge unbegrenzt. |
Werte |
Gibt eine Liste möglicher Werte für dieses Datenelement an. Wenn es sich bei dem Datenelement um eine Aufzählung handelt, enthält ValueMap den Indexwert, der dem in "Values" angegebenen Enumerationswert entspricht. |
ValueMap |
Gibt die ganzzahligen Werte der entsprechenden Zeichenfolgenwerte in "Values" an. |
WmiDataId(data-item-ID) |
(Erforderlich) Identifiziert ein Datenelement innerhalb eines Datenblocks. Datenelement-IDs müssen allen Elementen in einem Block zugewiesen werden, mit Ausnahme der erforderlichen Elemente InstanceName und Active. Datenelement-IDs müssen in einer zusammenhängenden Datenreihe zugewiesen werden, beginnend mit 1. Die Daten-ID eines Elements bestimmt die Reihenfolge, in der das Element in einer Instanz des Datenblocks angezeigt wird; Die Reihenfolge der Elemente in der MOF-Klassendefinition ist irrelevant. |
WmiMethodId(method-item-ID) |
Identifiziert eine Methode innerhalb eines Datenblocks. |
WmiSizeIs("data-item-name") |
Gibt den Namen eines anderen Datenelements in diesem Block an, das die Anzahl der Elemente im Array mit variabler Länge an diesem Datenelement angibt. WmiSizeIs sind nur für Datenelemente gültig, die Arrays definieren. |
WmiScale(scale-factor) |
Gibt den Skalierungsfaktor als Leistung von 10 an, den der Treiber beim Zurückgeben des Werts dieses Datenelements verwendet. Wenn der Skalierungsfaktor beispielsweise 5 ist, wird der vom Treiber zurückgegebene Wert mit 10⁵ multipliziert. Wenn WmiScale nicht angegeben wird, kann als Skalierungsfaktor 0 angenommen werden. |
WmiTimeStamp |
Gibt an, dass ein 64-Bit-Datenelement ein Zeitstempel in Einheiten von 100 Nanosekunden seit dem 1.1.1601 ist. WmiTimeStamp ist nur für 64-Bit-Datenelemente gültig. |
WmiComplexity(level) |
Gibt einen ganzzahligen Wert an, der die Komplexitätsebene des Datenelements ausdrückt. WMI-Clients können diesen Wert verwenden, um zwischen Datenelementen zu unterscheiden, die für Anfänger und Datenelemente verfügbar sein sollten, die auf erweiterte Benutzer beschränkt werden sollten. Null ist der Minimalwert, und höhere Werte deuten auf eine höhere Benutzerkomplexität hin. WmiComplexity ist standardmäßig null, wenn nicht angegeben. |
WmiVolatility(interval) |
Gibt das Intervall in Millisekunden zwischen Aktualisierungen dieses Datenelements an. Wenn beispielsweise ein Datenelement einmal pro Sekunde aktualisiert wird, beträgt das Intervall 1000. Ein WMI-Client überprüft möglicherweise WmiVolatility , um zu ermitteln, wie oft ein potenziell neuer Wert gesucht werden soll. Wenn WmiVolatility nicht angegeben wird, wird das Intervall nicht definiert. |
WmiEventTrigger( " data-item-name") |
Gibt den Namen eines Datenelements in einem Ereignisblock an, den ein WMI-Client festlegen kann, um den Triggerwert für das Ereignis zu definieren. Wenn beispielsweise das Ereignis TooHot mit WmiEventTrigger("TooHotTemperature") qualifiziert ist, könnte ein WMI-Client TooHotTemperature festlegen, um den Treiber anzuweisen, das TooHot-Ereignis zu senden, wenn das Gerät den vom Benutzer angegebenen Wert für TooHotTemperature erreicht hat. In der Regel definiert ein Treiber den Triggerwert. Durch das Verfügbarmachen eines WmiEventTrigger-Datenelements ermöglicht der Treiber einem Client die Steuerung, wann ein bestimmtes Ereignis ausgelöst wird. |
WmiEventRate("data-item-name") |
Gibt den Namen eines Datenelements in einem Ereignisblock an, den ein WMI-Client festlegen kann, um die Häufigkeit zu steuern, mit der dieses Ereignis gesendet wird. Wenn beispielsweise das Datenelement TooHot mit WmiEventRate("SendEventRate")qualifiziert ist, könnte ein WMI-Clientbenutzer SendEventRate festlegen, um den Treiber anzuweisen, TooHot im vom Benutzer angegebenen Intervall zu senden. |