標準限定符

發行項
11/10/2023

所有符合 CIM 標準的實作都必須處理一組標準限定符。任何特定對象都沒有列出的所有限定符。擴充類別通常會提供額外的限定符，以利在類別上布建類別實例和其他作業。

提供者必須負責強制執行限定符。 WMI 不會強制執行限定符，但只會使用它們來通知用戶屬性的使用方式。

注意

WMI 符合 CIM 2.5 規格。

限定符有下列限制：

並非所有標準限定符都可以一起使用。
並非所有限定符都可以套用至所有建構，例如關聯或參考。這些限制會在 [套用至] 列表中識別。
對於關聯或參考等特定建構，可能會進一步限制使用法律限定符，因為某些限定符互斥，使用一個限定符可能會暗示對另一個限定符的值有一些限制等等。記錄這些使用規則。
法律限定符只能由屬性、方法、實例或子類別等實體繼承，而不是由關聯或參考繼承。例如，套用至屬性的 MaxLen 限定符不會由參考繼承。

下列列出 WMI 標準限定符。

摘要

數據類型： 布爾值

適用於：類別、關聯、指示

指出類別是否為抽象，且僅做為新類別的基底。預設值為 FALSE。您無法建立抽象類的實例。缺少這個限定符表示類別不是抽象的;因此，所有抽象類都需要此限定符。

彙總

數據類型： 布爾值

適用於：參考

指出參考是否為匯總關聯之父元件。預設值為 FALSE。

使用方式：匯總和匯總限定符會一起使用匯總限定關聯，而 Aggregate 會指定父參考。

彙總

數據類型： 布爾值

適用於：關聯

指出關聯是否為匯總。預設值為 FALSE。與 Aggregate 搭配使用。所有匯總關聯都需要此限定符。

別名

數據類型：字串

適用於：屬性、參考、方法

架構中屬性或方法的替代名稱。預設值是 NULL。

ArrayType

數據類型：字串

適用於：屬性、參數

限定陣列的類型。

有效值為：

套件（預設值）
索引
排序

使用方式：僅將這種類型的限定符套用至陣列的屬性和參數（使用括號語法定義）。

點陣圖

數據類型： 字串陣列

適用於：屬性、方法、參數

重要位位置的對應，其中每個重要位置都可以「開啟」或「關閉」。每個「on」位都會對應至 BitValues 陣列中的對應值。藉由有多個位「開啟」，就會指出 BitValues 陣列中的多個並行值。預設值是 NULL。

如需詳細資訊，請參閱 BitMap 和 BitValues。

BitValues

數據類型： 字串陣列

適用於：屬性、方法、參數

將位位置值轉譯為相關聯的字串。預設值是 NULL。

如需詳細資訊，請參閱 BitMap 和 BitValues。

建構函式

數據類型： 布爾值

適用於：方法

指出方法是否建立實例。這些方法不限於在單一實例或單一類別上採取行動。例如，建構函式可以建立關聯實例，以及定義建構函式之類別的實例。

建構函式限定符僅供資訊使用，且預期物件管理員不會對它採取行動。建立物件時，物件管理員不需要呼叫建構函式方法。此外，呼叫建構函式時，物件管理員不需要叫用針對原始類別的任何父類別所定義的建構函式方法。預設值為 FALSE。

CreateBy

數據類型：字串

適用於：類別

建立這個類別實例的方法名稱。此值為 “PutInstance” 或另一個建立實例的方法名稱。預設值是 NULL。

使用方式：只有在 SupportsCreate 限定符存在時，才能使用此限定符。

DeleteBy

數據類型：字串

適用於：類別

刪除這個類別實例的方法名稱。此值為 “DeleteInstance”，或另一個刪除實例的方法名稱。預設值是 NULL。

使用方式：只有在 SupportsDelete 限定符存在時，才能使用此限定符。

說明

數據類型：字串

適用於：任何

具名專案的描述。預設值是 NULL。

析構函數

數據類型： 布爾值

適用於：方法

指出方法是否刪除實例。使用 解構函 式限定符的方法會刪除套用解構函式的實例，而且不會限製為在單一實例或類別上作用。例如，解構函式可能會刪除關聯實例，以及定義解構函式之類別的實例。

解構函式限定符僅供資訊使用，而且預期物件管理員不會處理它。物件管理員不需要在刪除實例時呼叫具有 解構函式 限定符的方法。此外，呼叫解構函式時，物件管理員不需要叫用針對原始類別之任何父類別所定義的解構函式方法。預設值為 FALSE。

DisplayName

數據類型：字串

適用於：任何

UI 中顯示的名稱，而不是專案的實際名稱。預設值是 NULL。

EmbeddedInstance

數據類型：字串

適用於：任何

限定字串類型專案包含內嵌實例。限定符值會指定與擁有限定專案之類別相同命名空間中的 CIM 類別名稱。內嵌實例是指定類別的實例，包括其子類別的實例。預設值是 NULL。

表

資料類型： 布林值

適用于：任何

指出屬性是否表示非負整數，它可以增加或減少，但永遠不會超過最大值。預設值為 FALSE 。

屬性的最大值不能大於 2^ n - 1。 N 可以是 8、16、32 或 64，視套用這個限定詞的屬性資料類型而定。每當模型化的資訊大於或等於該最大值時，量測計的值就會有其最大值。如果模型化的資訊後續會減少到最大值以下，量測計也會減少。此限定詞只適用于具有不帶正負號整數資料類型的屬性。

資料類型： 布林值

適用于：參數

指出參數是否用來將值傳遞至方法。預設值為 TRUE 。

In，Out

資料類型： 布林值

適用于：參數

指出參數是否同時為輸入和輸出參數。

索引鍵

資料類型： 布林值

適用于：屬性、參考

指出屬性是否為命名空間控制碼的一部分。如果有多個屬性具有 Key 限定詞，則所有這類屬性都會共同形成索引鍵（複合索引鍵）。結合在一起時，索引鍵屬性必須為每個類別實例提供唯一的參考。如果這個限定詞放在屬性上，則只允許 TRUE 值。

懶惰

適用于：屬性

表示屬性需要大量資源才能傳回，而且需要大量的處理器時間和記憶體。 WMI 不會嘗試傳回以延遲限定詞標示的屬性，藉此改善查詢的效能。

MappingStrings

資料類型： 字串陣列

適用于：類別、屬性、關聯、指示、參考

一組值，指出位置的路徑，您可以在其中找到屬性、類別、關聯、指示或參考之來源的詳細資訊。對應字串可以是目錄路徑、URL、登錄機碼、include 檔案、CIM 類別的參考或其他格式。預設值是 NULL。

Max

資料類型： int

適用于：參考

給定參考可以針對關聯中每個其他參考值集擁有的值數目上限。預設值是 NULL。例如，如果關聯將 A 實例關聯至 B 實例，而且每個 B 實例最多必須有一個 A 實例，則 A 的參考應該最多隻能有一個限定詞。

MaxLen

資料類型： int

適用于：屬性、方法、參數

字串 資料項目的最大 長度（以字元為單位），並表示支援固定長度陣列。

如果遇到固定長度陣列， MaxLen 限定詞會包含剖析期間找到的固定長度。如果遇到可變長度陣列，則不會使用此限定詞。 MaxLen 用來建議應該儲存在陣列中的元素數目上限。覆寫預設值時，可以指定任何不帶正負號的整數值（ uint32 ）。 Null 值（預設值）表示無限長度。

MaxValue

資料類型： int

適用于：屬性、方法、參數

物件的最大值。預設值是 NULL。

Min

資料類型： int

適用于：參考

參考的最小基數（給定參考可以針對關聯中每個其他參考值集合的最小值數目）。預設值是 0。

例如，如果關聯將 A 實例關聯至 B 實例，而且每個 B 實例至少必須有一個 A 實例，則 A 的參考應該至少有一個限定詞。

MinValue

資料類型： int

適用于：屬性、方法、參數

表示物件的最小值。預設值是 NULL。

ModelCorrespondence

資料類型： 字串陣列

適用于：屬性

一組值，表示物件屬性與 CIM 架構中其他屬性之間的對應。預設值是 NULL。

物件屬性是使用下列語法來識別。

<架構名稱 > 「_」 < 類別或關聯名稱 > 「.」 <屬性名稱>

外地

資料類型：字串

適用于：參考

實例的位置，其 < 值為 namespacetype > ：// < namespacehandle > 預設值為 Null 。

使用方式：此限定詞無法與 NonlocalType 限定詞搭配 使用。

NonlocalType

資料類型：字串

適用于：參考

實例的位置類型。其值為 < namespacetype > 。預設值是 NULL。

使用方式：此限定詞無法與 Nonlocal 限定詞搭配 使用。

NullValue

資料類型：字串

適用于：屬性

值，表示相關聯的屬性為 Null （屬性沒有有效或有意義的值）。預設值是 NULL。

用來定義 Null 值的慣例和限制，與適用于 ValueMap 限定詞的慣例和限制相同。請注意，無法覆寫此限定詞。不允許子類別傳回與父類別不同的 Null 值是不合理的。

外

資料類型： 布林值

適用于：參數

指出參數是否從方法傳回值。預設值為 FALSE 。

覆寫

資料類型：字串

適用于：屬性、方法、參考

由衍生類別中相同名稱的屬性、方法或參考覆寫的父類別或次級建構（屬性、方法或參考）。預設值是 NULL。

格式為：

[ < class > .] < 從屬建構>

如果省略類別名稱，覆寫會套用至類別階層中父類別中的次級建構。

使用方式：覆寫限定詞只能參考以相同中繼模型為基礎的建構。在覆寫作業期間，不允許變更建構名稱或簽章。

OverrideValue

適用于：類別

指出子類別上的屬性值是否覆寫父類別中的值。功能含意是，如果您對父類別執行查詢，而且您的 WHERE 子句包含這個屬性，父系必須傳回具有覆寫值的實例。因此，Windows 管理會 調整傳送至父類別之查詢的 WHERE 子句，以排除對此屬性的參考。

傳播

資料類型：字串

適用於：屬性

要傳播的金鑰名稱。預設值是 NULL。

使用此限定符假設在具有包含類別做為其目標的參考中，只有一個弱式限定符存在。關聯的屬性必須與弱式關聯另一端類別中限定符所命名的屬性具有相同的值。格式為：

[<class>.]<從屬建構>

使用方式：使用傳播限定符時，必須以 TRUE 值指定金鑰限定符。

讀取

數據類型： 布爾值

適用於：屬性

指出屬性是否可讀取。預設值為 TRUE。

必要

數據類型： 布爾值

適用於：屬性

指出屬性是否需要非 Null 值。預設值為 FALSE。

修訂

數據類型：字串

適用於：類別、關聯、指示、架構

架構物件的次要修訂編號。預設值是 NULL。

使用方式：使用修訂限定符時，版本限定符必須存在，才能提供主要版本號碼。

結構描述

數據類型：字串

適用於：屬性、方法

定義功能之架構的名稱。預設值是 NULL。

來源

數據類型：字串

適用於：類別、關聯、指示、參考

實例的位置。預設值是 NULL。

限定符的值是 <namespacetype>：//<namespacehandle>。

使用方式：來源限定符不能與SourceType限定符搭配使用。

SourceType

數據類型：字串

適用於：類別、關聯、指示、參考

實例的位置類型。這個限定符的值是 <namespacetype>。預設值是 NULL。

使用方式：SourceType 限定符無法與來源限定符搭配使用。

SupportsCreate

數據類型： 布爾值

適用於：類別

指出類別是否支援建立實例。預設值為 FALSE。

SupportsDelete

數據類型： 布爾值

適用於：類別

指出類別是否支援刪除實例。預設值為 FALSE。

SupportsUpdate

數據類型： 布爾值

適用於：類別

指出類別是否支持實例的修改（更新）。預設值為 FALSE。

終端機

數據類型： 布爾值

適用於：類別

指出類別是否可以有子類別。預設值為 FALSE。

如果宣告子類別，編譯程式會產生錯誤。

使用方式：此限定符無法與抽象限定符共存。 如果同時指定終端機和抽象限定符，編譯程式會產生錯誤。

單位

數據類型：字串

適用於：屬性、方法、參數

表示相關聯數據項的單位類型。預設值是 NULL。

例如，size 數據項可能會有 Units 的 “bytes” 值。

ValueMap

數據類型： 字串陣列

適用於：屬性、方法、參數

屬性、方法傳回型別或方法參數的允許值集。預設值是 NULL。

使用方式：此限定符可以單獨使用或與 Values 限定符搭配使用。搭配 Values 限定符使用時，ValueMap 陣列中的值位置會提供 Values 陣列中對應專案的位置。 僅搭配字串和整數值使用 ValueMap 限定符。表示值對應數位中整數值的語法為 [+|=]digit[*digit]。內容、最大位數和表示值會受限於相關聯屬性的類型。例如，uint8 可能未帶正負號、必須小於四位數，而且必須代表小於 256 的值。

值

數據類型： 字串陣列

適用於：屬性、方法、參數

一組值會將整數值轉譯為相關聯的字串。預設值是 NULL。

這個屬性也會指定要對應至列舉屬性的字串值陣列。這個限定符可以套用至整數屬性或字串屬性，而且對應可以是隱含或明確的。如果對應是隱含的，整數或字串屬性值代表 Values 陣列中的序數位置。如果對應明確，屬性必須是整數，而且有效的屬性值會列在 ValueMap 限定符定義的數位中。如需詳細資訊，請參閱值對應。

如果 ValueMap 限定符不存在，則 Values 陣列會使用相關聯屬性、方法傳回型別或方法參數中的值來編製索引（零相對值）。 如果 ValueMap 限定符存在，則值索引是由值對應中屬性值的位置所定義。

版本

數據類型：字串

適用於：類別、架構、關聯、指示

架構物件的主要版本號碼。預設值是 NULL。變更變更介面的架構時，版本號碼會遞增。

弱

數據類型： 布爾值

適用於：參考

指出參考類別的索引鍵是否包含關聯中其他參與者的索引鍵。預設值為 FALSE。

當參考類別的身分識別取決於關聯中其他參與者的身分識別時，會使用此限定符。任何指定類別的參考都不能超過一個。關聯中的其他類別必須定義索引鍵。關聯中其他類別的索引鍵會在參考類別中重複，並以傳播限定符標記。

寫入

數據類型： 布爾值

適用於：屬性

表示應用程式或文稿可以變更屬性值。執行應用程式的帳戶必須能夠存取包含類別實例的命名空間。提供者實作也可能限制對提供者數據的存取。 TRUE 值表示屬性可由 WMI 和提供者允許存取的取用者讀取和寫入。預設值為 FALSE。

缺少寫入限定符的屬性可能仍然可以寫入。提供者實作可能會允許變更提供者類別中的任何屬性，不論寫入限定符是否存在。

WriteAtCreate

數據類型： 布爾值

適用於：屬性

指出屬性是否可以在實例建立時寫入。此限定符可與 WriteAtCreate 限定符搭配使用。預設值為 FALSE。

WriteAtUpdate

數據類型： 布爾值

適用於：屬性

指出屬性是否可在實例更新時寫入。此限定符可與 WriteAtCreate 限定符搭配使用。預設值為 FALSE。

需求

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

另請參閱

WMI 限定符
新增限定符

共用方式為

標準限定符

需求

另請參閱

意見反應

其他資源