Sdílet prostřednictvím


Kvalifikátory vlastností rozhraní WMI

Následující tabulka uvádí požadované a volitelné kvalifikátory vlastností MOF, které lze použít k definování položek v datech rozhraní WMI nebo bloku událostí.

The following are standard MOF qualifiers: key, read, write, ValueMap, and Values. Další informace o těchto a dalších standardních kvalifikátorech MOF najdete v tématu Datové typy MOF.

Qualifier Description

key

Označuje, že datová položka je klíčovou vlastností, která jednoznačně identifikuje každou instanci třídy. Klíč lze deklarovat pouze vlastností InstanceName.

read

Označuje, že klient služby WMI může číst datovou položku.

write

Označuje, že klient služby WMI může nastavit datovou položku.

BitMap

Specifies the bit positions of the corresponding string values that are specified in BitValues.

BitValues

Určuje seznam řetězcových hodnot (názvy příznaků), které představují bity nastavené v položce dat. The bit position of a flag is defined by the corresponding position specified in BitMap.

DefineValues

Určuje výčtový seznam, který sada nástrojů WMI zkompiluje do odpovídajícího seznamu příkazů #define.

DisplayInHex

Určuje, že každý klient rozhraní WMI, který zobrazuje hodnotu vlastnosti, by to měl provést v šestnáctkovém.

DisplayName("string")

Určuje titulek, který může klient rozhraní WMI použít k zobrazení jako název vlastnosti.

MaxLen(uint)

For string properties, MaxLen specifies the maximum length of the string in characters. The uint value can be any 32-bit unsigned integer. If MaxLen is omitted, or uint is zero, then the length of the string is unlimited.

Values

Určuje seznam možných hodnot pro tuto položku dat. If the data item is an enumeration, ValueMap contains the index value that corresponds to the enumeration value specified in Values.

ValueMap

Specifies the integer values of the corresponding string values in Values.

WmiDataId(data-item-ID)

(Povinné) Identifikuje datovou položku v rámci datového bloku. Data item IDs must be assigned to all items in a block except the required items InstanceName and Active. ID datových položek musí být přiřazena v souvislé řadě počínaje číslem 1. ID dat položky určuje pořadí, ve kterém se položka zobrazuje v instanci datového bloku; pořadí položek v definici třídy MOF je irelevantní.

WmiMethodId(method-item-ID)

Identifikuje metodu v rámci datového bloku.

WmiSizeIs("data-item-name")

Určuje název jiné datové položky v tomto bloku, který označuje počet prvků v poli s proměnnou délkou u této datové položky. WmiSizeIs is valid only for data items that define arrays.

WmiScale(scale-factor)

Určuje faktor měřítka, jako výkon 10, který ovladač používá při vrácení hodnoty této datové položky. For example, if scale-factor is 5, the value returned by the driver is multiplied by 10⁵. If WmiScale is omitted, scale-factor can be assumed to be 0.

WmiTimeStamp

Určuje, že 64bitová datová položka je časové razítko v jednotkách 100 nanosekund od 1. 1. 1601. WmiTimeStamp is valid only for 64-bit data items.

WmiComplexity(level)

Určuje celočíselnou hodnotu, která vyjadřuje úroveň složitosti uživatele datové položky. Klienti rozhraní WMI můžou tuto hodnotu použít k rozlišení datových položek, které by měly být dostupné novým uživatelům a datovým položkám, které by měly být omezeny na pokročilejší uživatele. Nula je minimální hodnota a vyšší hodnoty označují vyšší složitost uživatele. WmiComplexity defaults to zero if not specified.

WmiVolatility(interval)

Určuje interval mezi aktualizacemi této datové položky v milisekundách. For example, if a data item is updated once each second, interval would be 1000. A WMI client might check WmiVolatility to determine how often to query for a potentially new value. If WmiVolatility is omitted, interval is undefined.

WmiEventTrigger("data-item-name")

Určuje název datové položky v bloku události, který může klient rozhraní WMI nastavit tak, aby definoval hodnotu aktivační události. For example, if the event TooHot is qualified with WmiEventTrigger("TooHotTemperature"), a WMI client could set TooHotTemperature to instruct the driver to send the TooHot event when the device reached the user-specified value for TooHotTemperature. Ovladač obvykle definuje hodnotu triggeru. By exposing a WmiEventTrigger data item, the driver allows a client to control when a particular event is fired.

WmiEventRate("data-item-name")

Určuje název datové položky v bloku událostí, který může klient rozhraní WMI nastavit pro řízení četnosti odesílání této události. For example, if the data item TooHot is qualified with WmiEventRate("SendEventRate"), a WMI client user could set SendEventRate to instruct the driver to send TooHot at the user-specified interval.