Udostępnij za pośrednictwem


Kwalifikatory właściwości WMI

W poniższej tabeli wymieniono wymagane i opcjonalne kwalifikatory właściwości MOF, które mogą służyć do definiowania elementów w danych usługi WMI lub bloku zdarzeń.

The following are standard MOF qualifiers: key, read, write, ValueMap, and Values. Aby uzyskać więcej informacji na temat tych i innych standardowych kwalifikatorów MOF, zobacz MOF Data Types (Typy danych MOF).

Qualifier Description

key

Wskazuje, że element danych jest właściwością klucza, która jednoznacznie identyfikuje każde wystąpienie klasy. Klucz można zadeklarować tylko za pomocą właściwości InstanceName.

read

Wskazuje, że klient usługi WMI może odczytać element danych.

write

Wskazuje, że klient usługi WMI może ustawić element danych.

BitMap

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

BitValues

Określa listę wartości ciągu (nazw flag), które reprezentują bity ustawione w elemencie danych. The bit position of a flag is defined by the corresponding position specified in BitMap.

DefineValues

Określa wyliczona lista, którą pakiet narzędzi WMI kompiluje do odpowiedniej listy instrukcji #define.

DisplayInHex

Określa, że każdy klient WMI, który wyświetla wartość właściwości, powinien to zrobić w szesnastkowym.

DisplayName("string")

Określa podpis, którego klient usługi WMI może użyć do wyświetlenia jako nazwy właściwości.

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

Określa listę możliwych wartości dla tego elementu danych. 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)

(Wymagane) Identyfikuje element danych w bloku danych. Data item IDs must be assigned to all items in a block except the required items InstanceName and Active. Identyfikatory elementów danych muszą być przypisane w ciągłej serii, począwszy od 1. Identyfikator danych elementu określa kolejność wyświetlania elementu w wystąpieniu bloku danych; kolejność elementów w definicji klasy MOF jest nieistotna.

WmiMethodId(method-item-ID)

Identyfikuje metodę w bloku danych.

WmiSizeIs("data-item-name")

Określa nazwę innego elementu danych w tym bloku, który wskazuje liczbę elementów w tablicy o zmiennej długości w tym elemencie danych. WmiSizeIs is valid only for data items that define arrays.

WmiScale(scale-factor)

Określa współczynnik skalowania, jako moc 10, którego używa sterownik podczas zwracania wartości tego elementu danych. 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

Określa, że 64-bitowy element danych jest sygnaturą czasową w jednostkach 100 nanosekund od 1/1/1601. WmiTimeStamp is valid only for 64-bit data items.

WmiComplexity(level)

Określa wartość całkowitą, która wyraża poziom złożoności użytkownika elementu danych. Klienci WMI mogą używać tej wartości, aby odróżnić elementy danych, które powinny być dostępne dla początkujących użytkowników i elementów danych, które powinny być ograniczone do bardziej zaawansowanych użytkowników. Zero jest wartością minimalną, a wyższe wartości wskazują na wyższą złożoność użytkownika. WmiComplexity defaults to zero if not specified.

WmiVolatility(interval)

Określa interwał (w milisekundach) między aktualizacjami tego elementu danych. 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")

Określa nazwę elementu danych w bloku zdarzeń, który klient WMI może ustawić, aby zdefiniować wartość wyzwalacza dla zdarzenia. 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. Zazwyczaj sterownik definiuje wartość wyzwalacza. By exposing a WmiEventTrigger data item, the driver allows a client to control when a particular event is fired.

WmiEventRate("data-item-name")

Określa nazwę elementu danych w bloku zdarzeń, który klient WMI może ustawić w celu kontrolowania częstotliwości wysyłania tego zdarzenia. 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.