標準 WMI 限定詞
下列列出 WMI 特有的標準限定詞。
修訂
資料類型: 布林值
適用于:類別
表示類別包含當地語系化的修改限定詞。 預設值為 TRUE。
可以轉譯相關聯的類別。 若要存取翻譯的版本,請使用地區設定識別碼來建構命名空間名稱。
Bypass_GetObject
資料類型: 布林值
適用于:方法
表示方法呼叫應該直接傳遞至提供者的 ExecMethodAsync 呼叫,而不是提供者先呼叫 GetObject 來驗證物件路徑。 預設值為 FALSE。 使用 Bypass_GetObject 可以大幅改善效能。
使用 Bypass_GetObject之前,請確定不會採取下列任一動作:
- 從類別衍生類別。
- 覆寫具有 Bypass_GetObject 限定詞的方法。
無法遵循這些預防措施,可能會導致叫用父類別的方法實作,而不是子類別。 如需詳細資訊,請參閱使用Bypass_GetObject限定詞。
CIM_Key
資料類型: CIM_BOOLEAN
適用于:屬性
表示相關聯的屬性是 CIM 中的索引鍵屬性,但在 WMI 中則不是。
資料類型: VT_BSTR
適用于:屬性、方法、參數
包含描述屬性類型的文字。
ClassCoNtext
資料類型: VT_BSTR
適用于:類別
表示類別具有與提供者動態提供之詳細資訊相關聯的實例。
廢棄
資料類型: CIM_BOOLEAN
適用于:屬性、類別
表示屬性已由另一個屬性取代。
顯示
適用于:類別、屬性
相關聯類別的 UUID 。
資料類型: 布林值
適用于:類別、屬性
指出動態建立實例的類別。 這個限定詞的值必須設定為 TRUE。
DynProps
資料類型: 布林值
適用于:類別、實例
表示實例包含動態屬性提供者所提供的值。 預設值為 TRUE。
您必須在這類實例上指定此限定詞。 只允許 TRUE 值。
固定
資料類型: CIM_BOOLEAN
適用于:實例
表示這個屬性的值在實例的存留期內無法變更。
Id
資料類型: VT_I4
適用于:屬性、參數
自動產生 MOF 語句時,可唯一識別和排序屬性或方法參數。
只有方法參數才需要此限定詞。 為方法建立參數時,類別設計工具的開頭應該是第一個參數的識別碼 (0) ,並針對每個後續參數使用每個連續整數。 如果不小心省略 識別碼 限定詞,MOF 編譯器會自動產生 識別碼 限定詞。
實現
資料類型: 布林值
適用于:方法
表示方法具有提供者所提供的實作。
InstanceCoNtext
資料類型: VT_BSTR
適用于:實例
表示實例包含動態屬性提供者所提供的值。
此值會傳遞至屬性提供者做為 IWbemPropertyProvider::GetProperty 方法的引數。
現場
資料類型: VT_BSTR
適用于:類別或實例
指定類別或實例的原始語言。 如需地區設定值的詳細資訊,請參閱 地區設定代碼。
NamespaceSecuritySDDL
資料類型: 字串陣列
適用于:命名空間實例
以 SDDL 格式指定命名空間的安全性描述元。 如需詳細資訊,請參閱 建立命名空間時設定命名空間安全性。 SDDL 字串是由 WMI 處理,以建立命名空間安全性,但不會儲存為字串。 如果未指定任何安全性描述元,則會使用預設安全性。 如需詳細資訊,請參閱 設定 Namepace 安全性描述元。
選
資料類型: 布林值
適用于:參數
表示不需要參數,而且其具有行為良好的預設值。
特權
資料類型: 字串陣列
適用于:屬性、方法
用來通知用戶端建立實例、填入屬性或執行方法所需的許可權集合。 預設值為 FALSE。
PropertyCoNtext
資料類型: VT_BSTR
適用于:屬性
表示實例屬性包含動態屬性提供者所提供的值。
您必須在這類屬性上指定這個限定詞。 這個值會以引數的形式傳遞至屬性提供者給 IWbemPropertyProvider::GetProperty。
供應商
資料類型: VT_BSTR
適用于:類別
這個限定詞的值是動態提供者的名稱,可提供類別實例並重新整理實例資料。 您必須使用包含此名稱的Name屬性建立__Win32Provider類別的實例,向 WMI 註冊此名稱。 當這個限定詞指定于動態提供實例的類別上時,也必須指定 動態 限定詞。
RequiresEncryption
資料類型: 布林值
適用于:命名空間實例
如果設定為 TRUE, RequiresEncryption 會標示命名空間,讓用戶端應用程式和腳本必須與加密驗證連線。 驗證層級必須在 C++ 中 設定為 RPC_C_AUTHN_LEVEL_PKT_PRIVACY 。 在腳本或 Visual Basic 中,驗證層級必須設定為 WbemAuthenticationLevelPktPrivacy。 如需詳細資訊,請參閱 設定 Namepace 安全性描述元。 限定詞會搭配 pragma 命名空間預處理器命令在 MOF 中使用。
如需詳細資訊,請參閱 使用 C++ 設定預設進程安全性層級 或使用 VBScript 設定預設進程安全性層級。 腳本驗證層級定義于 WbemAuthenticationLevelEnum中。
單身 人士
資料類型: 布林值
適用于:類別
指定只能有一個實例且不包含索引鍵屬性的類別。
只允許預設值 TRUE () 。
靜態
資料類型: 布林值
適用于:方法
指出方法是否可以使用類別定義或其實例來呼叫。
無法從 實例叫用 方法。
亞
資料類型: VT_BSTR
適用于:屬性
表示 類型為 CIM_DATETIME 的屬性代表時間間隔,而不是特定時間。
若要將屬性識別為間隔,此限定詞的值必須是 「interval」。 此限定詞的所有其他值都會保留供日後使用。
Uuid
資料類型: 字串
適用于:類別
套用至 類別的通用唯一識別碼。
ClassVersion
資料類型: 字串
適用于:類別
類別物件的版本號碼。 預設值是 NULL。 對 類別進行變更時,版本號碼會遞增。
WritePrivileges
資料類型: 字串陣列
適用于:屬性
一組值,指出哪些系統許可權必須可供使用,並啟用成功寫入作業。
備註
地區設定代碼
地區設定程式碼的格式為 「MS_ < Three 數位語言識別項 > 」。 例如,英文地區設定MS_409。 下表列出語言識別項。
語言 | 語言識別項 (十六進位) |
---|---|
阿拉伯文 | 401 |
葡萄牙文 (巴西) | 416 |
簡體中文 | 804 |
繁體中文 | 404 |
捷克文 | 405 |
丹麥文 | 406 |
荷蘭文 | 413 |
英文 (預設值) | 409 |
芬蘭文 | 40b |
法文 | 40c |
德文 | 407 |
希臘文 | 408 |
Hebrew | 40d |
匈牙利文 | 40e |
義大利文 | 410 |
日文 | 411 |
韓文 | 412 |
挪威文 | 414 |
波蘭文 | 415 |
葡萄牙文 (葡萄牙) | 816 |
俄文 | 419 |
西班牙文 | c0a |
瑞典文 | 41D |
土耳其文 | 41f |
使用Bypass_GetObject限定詞
在方法上使用 Bypass_GetObject 限定詞,可能會產生令人困惑的結果。
下列範例會定義 Shape 和 Circle 類別。 請注意 ,Circle 類別衍生自 Shape 類別。
class Shape
{
string Name;
uint32 DrawIt(); // - draws an irregular geometric shape
};
class Circle : Shape
{
uint32 DrawIt(); // - draws a circle
};
下列 ExecMethod 呼叫會使用名為 「MyCircle」 的 Circle 物件來繪製圓形。
ExecMethod("Shape.Name='MyCircle'","DrawIt");
在先前的案例中,WMI 會呼叫GetObject;發現 「Shape.Name='MyCircle'」 是Circle;並執行DrawIt的Circle實作。 不過,如果您在DrawIt上使用Bypass_GetObject限定詞,WMI 不會呼叫GetObject,並不會發現 「Shape.Name='MyCircle'」 是Circle,並執行DrawIt的Shape實作,而不是DrawIt的Circle實作。
下列 ExecMethod 呼叫一律會叫用 DrawIt的正確實作。
ExecMethod("Circle.Name='MyCircle'","DrawIt");
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows Vista |
最低支援的伺服器 |
Windows Server 2008 |