標準 WMI 限定詞

  • 發行項

下列列出 WMI 特有的標準限定詞。

修訂

資料類型： 布林值

適用于：類別

表示類別包含當地語系化的修改限定詞。 預設值為 TRUE。

可以轉譯相關聯的類別。 若要存取翻譯的版本，請使用地區設定識別碼來建構命名空間名稱。

Bypass_GetObject

資料類型： 布林值

適用于：方法

表示方法呼叫應該直接傳遞至提供者的 ExecMethodAsync 呼叫，而不是提供者先呼叫 GetObject 來驗證物件路徑。 預設值為 FALSE。 使用 Bypass_GetObject 可以大幅改善效能。

使用 Bypass_GetObject之前，請確定不會採取下列任一動作：

  • 從類別衍生類別。
  • 覆寫具有 Bypass_GetObject 限定詞的方法。

無法遵循這些預防措施，可能會導致叫用父類別的方法實作，而不是子類別。 如需詳細資訊，請參閱使用Bypass_GetObject限定詞。

CIM_Key

資料類型： CIM_BOOLEAN

適用于：屬性

表示相關聯的屬性是 CIM 中的索引鍵屬性，但在 WMI 中則不是。

CIMType

資料類型： 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

另請參閱

設定 Namepace 安全性描述項

WMI 限定詞

新增限定詞