WMI 屬性限定符
下表列出必要和選擇性的MOF屬性限定符,可用來定義WMI資料或事件區塊中的專案。
以下是標準MOF限定符: 索引鍵、 讀取、 寫入、 ValueMap和 Values。 如需這些和其他標準MOF限定符的詳細資訊,請參閱 MOF資料類型。
Qualifier | 描述 |
---|---|
key |
表示數據項是索引鍵屬性,可唯一識別類別的每個實例。 只有 InstanceName 屬性可以宣告索引鍵。 |
read |
表示 WMI 用戶端可以讀取數據項。 |
write |
指出 WMI 用戶端可以設定數據項。 |
點陣圖 |
指定 BitValues 中所指定之對應字串值的位位置。 |
BitValues |
指定字串值清單(旗標名稱),代表數據項中設定的位。 旗標的位位置是由 BitMap 中指定的對應位置所定義。 |
DefineValues |
指定 WMI 工具套件編譯成對應 #define 語句清單的列舉清單。 |
DisplayInHex |
指定任何顯示屬性值的 WMI 用戶端都應該在十六進位中執行此動作。 |
DisplayName(“string”) |
指定 WMI 用戶端可用來顯示為屬性名稱的標題。 |
MaxLen(uint) |
針對字串屬性, MaxLen 會以字元指定字串的最大長度。 uint 值可以是任何 32 位無符號整數。 如果省略 MaxLen,或 uint 為零,則字串的長度無限制。 |
值 |
指定此資料項的可能值清單。 如果數據項是列舉,ValueMap 會包含對應至 Values 中所指定列舉值的索引值。 |
ValueMap |
指定 Values 中對應字串值的整數值。 |
WmiDataId(data-item-ID) |
(必要)識別數據區塊內的數據項。 數據項標識碼必須指派給區塊中的所有專案,但必要專案 InstanceName 和 Active 除外。 數據項標識碼必須在連續數列中指派,從 1 開始。 項目的數據標識符會決定專案出現在數據區塊實例中的順序;MOF 類別定義中的項目順序無關緊要。 |
WmiMethodId(method-item-ID) |
識別數據區塊內的方法。 |
WmiSizeIs(“data-item-name”) |
指定此區塊中另一個數據項的名稱,指出此數據項之可變長度陣列中的元素數目。 WmiSizeIs 僅適用於定義數位的數據項。 |
WmiScale(scale-factor) |
指定縮放比例,做為10的乘冪,驅動程式會在傳回此資料項的值時使用。 例如,如果 scale-factor 為 5,則驅動程式傳回的值乘以 10⁵。 如果 省略 WmiScale , 則可以假設縮放比例 為 0。 |
WmiTimeStamp |
指定 64 位數據項是時間戳,單位為 100 奈秒,自 1/1/1601 起。 WmiTimeStamp 僅適用於 64 位數據項。 |
WmiComplexity(level) |
指定整數值,表示數據項的使用者複雜度層級。 WMI 用戶端可以使用該值來區分應該提供給新手用戶的數據項,以及應該限制為更進階用戶的數據項。 零是最小值,而較高的值表示較高的用戶複雜度。 如果未指定,WmiComplexity 預設為零。 |
WmiVolatility(interval) |
指定此數據項更新之間的間隔,以毫秒為單位。 例如,如果數據項每秒更新一次, 間隔 會是 1000。 WMI 用戶端可能會檢查 WmiVolatility ,以判斷查詢潛在新值的頻率。 如果 省略 WmiVolatility , 則間隔 為未定義。 |
WmiEventTrigger(“ data-item-name”) |
指定事件區塊中的數據項名稱,WMI 用戶端可以設定為定義事件的觸發程式值。 例如,如果 TooHot 事件符合 WmiEventTrigger(“TooHotTemperature”),則 WMI 用戶端可以設定 TooHotTemperature,以指示驅動程式在裝置達到 TooHotTemperature 的使用者指定值時傳送 TooHot 事件。 一般而言,驅動程式會定義觸發程式值。 藉由公開 WmiEventTrigger 數據項,驅動程式可讓用戶端控制引發特定事件的時間。 |
WmiEventRate(“data-item-name”) |
指定事件區塊中的數據項名稱,WMI 用戶端可以設定為控制傳送此事件的頻率。 例如,如果數據項 TooHot 符合 WmiEventRate(“SendEventRate”)的限定,則 WMI 用戶端使用者可以設定 SendEventRate,以指示驅動程式在使用者指定的間隔傳送 TooHot。 |