共用方式為


標準 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

適用於:實例

表示這個屬性的值無法在實例的存留期期間變更。

標識碼

數據類型: VT_I4

適用於:屬性、參數

自動產生MOF語句時,可唯一識別和排序屬性或方法參數。

只有方法參數才需要此限定符。 為方法建立參數時,類別設計工具應該從第一個參數的Id(0) 開始,並針對每個後續參數使用每個連續整數。 如果意外省 略標識元限定 符,MOF 編譯程式會自動產生 標識元 限定符。

實作

數據類型: 布爾值

適用於:方法

表示方法具有提供者提供的實作。

InstanceContext

數據類型: VT_BSTR

適用於:實例

表示實例包含動態屬性提供者所提供的值。

值會傳遞至屬性提供者,做為 IWbemPropertyProvider::GetProperty 方法的自變數。

地區設定

數據類型: VT_BSTR

適用於:類別或實例

指定類別或實例的來源語言。 如需地區設定值的詳細資訊,請參閱 地區設定代碼

NamespaceSecuritySDDL

數據類型: 字串陣列

適用於:命名空間實例

SDDL 格式指定命名空間的安全性描述元。 如需詳細資訊,請參閱在建立命名空間時 設定命名空間安全性。 SDDL 字串會由 WMI 處理,以建立命名空間安全性,但不會儲存為字串。 如果未指定任何安全性描述元,則會使用預設安全性。 如需詳細資訊,請參閱 設定命名空間安全性描述元

自選

數據類型: 布爾值

適用於:參數

表示參數並非必要,而且具有行為良好的預設值。

特權

數據類型: 字串陣列

適用於:屬性、方法

用來通知用戶端建立實例、填入屬性或執行方法所需的許可權集合。 預設值為 FALSE

PropertyContext

數據類型: VT_BSTR

適用於:屬性

表示實例屬性包含動態屬性提供者所提供的值。

您必須在這類屬性上指定這個限定符。 值會傳遞至屬性提供者,做為 IWbemPropertyProvider::GetProperty 的自變數。

提供者

數據類型: VT_BSTR

適用於:類別

這個限定符的值是提供類別實例並重新整理實例數據的動態提供者名稱。 您必須使用包含此名稱的 Name 屬性,建立__Win32Provider類別的實例,向 WMI 註冊此名稱。 當這個限定符在實例以動態方式提供的類別上指定時,也必須指定 動態 限定符。

RequiresEncryption

數據類型: 布爾值

適用於:命名空間實例

如果設定為 TRUE,RequiresEncryption 會標示命名空間,讓用戶端應用程式和腳本必須與加密驗證連線。 驗證層級必須設定為 C++ 中的 RPC_C_AUTHN_LEVEL_PKT_PRIVACY 。 在腳本或Visual Basic中,驗證層級必須設定為 WbemAuthenticationLevelPktPrivacy。 如需詳細資訊,請參閱 設定命名空間安全性描述元。 限定符會搭配 pragma 命名空間預處理器命令在 MOF 中使用。

如需詳細資訊,請參閱 使用 C++ 設定預設進程安全性層級 或使用 VBScript 設定預設進程安全性層級。 腳本驗證層級定義於 WbemAuthenticationLevelEnum 中。

單身人士

數據類型: 布爾值

適用於:類別

指定只能有一個實例且不包含索引鍵屬性的類別。

允許TRUE ( 預設值) 值。

靜態的

數據類型: 布爾值

適用於:方法

指出方法是否可以使用類別定義或其實例來呼叫。

無法從 實例叫用 方法。

數據類型: VT_BSTR

適用於:屬性

表示類型 為 CIM_DATETIME 的屬性代表時間間隔,而不是特定時間。

若要將屬性識別為間隔,這個限定符的值必須是 “interval”。 此限定符的其他所有值都會保留供日後使用。

UUID

數據類型: 字串

適用於:類別

套用至 類別的通用唯一標識符。

ClassVersion

數據類型: 字串

適用於:類別

類別物件的版本號碼。 預設值為 NULL。 對類別進行變更時,版本號碼會遞增。

WritePrivileges

數據類型: 字串陣列

適用於:屬性

一組值,指出哪些系統許可權必須可供使用,並針對成功的寫入作業啟用。

備註

地區設定代碼

地區設定程式代碼的格式為 「MS_<Three Digit Language ID>」。。 例如,英文地區設定MS_409。 下表列出語言標識碼。

語言 語言識別碼 (十六進位)
阿拉伯文 401
葡萄牙文(巴西) 416
中文(簡體) 804
中文 (繁體) 404
捷克 405
丹麥文 406
荷蘭語 413
英文 (預設) 409
芬蘭文 40b
法語 40c
德語 407
希臘語 408
希伯來文 40d
匈牙利語 40e
義大利語 410
日語 411
朝鮮語 412
挪威文 414
波蘭語 415
葡萄牙文 (葡萄牙) 816
俄語 419
西班牙文 c0a
瑞典文 41D
土耳其文 41f

使用Bypass_GetObject限定符

在方法上使用 Bypass_GetObject 限定符可能會產生令人困惑的結果。

下列範例會定義 ShapeCircle 類別。 請注意, 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;和會執行 DrawItCircle 實作。 不過,如果您在 DrawIt 上使用Bypass_GetObject限定符,WMI 不會呼叫 GetObject,則不會發現 “Shape.Name='MyCircle'” 是 Circle,並執行 DrawItShape 實作,而不是 DrawItCircle 實作。

下列 ExecMethod 呼叫一律會叫用 DrawIt 的正確實作。

ExecMethod("Circle.Name='MyCircle'","DrawIt");

需求

要求 價值觀
最低支援的用戶端
Windows Vista
最低支援的伺服器
Windows Server 2008

另請參閱

設定命名空間安全性描述元

WMI 限定符

新增限定符