__ObjectProviderRegistration 類別
__ObjectProviderRegistration抽象系統類別可作為用於在 WMI 中註冊類別和執行個體提供者之類別的父類別。
下列語法已從受管理物件格式 (MOF) 程式碼加以簡化,並包含所有繼承的屬性。 屬性會依字母順序列出,而非 MOF 順序。
語法
[abstract]
class __ObjectProviderRegistration : __ProviderRegistration
{
sint32 InteractionType = 0;
__Provider REF provider;
string QuerySupportLevels[];
boolean SupportsBatching;
boolean SupportsDelete = False;
boolean SupportsEnumeration = False;
boolean SupportsGet = False;
boolean SupportsPut = False;
boolean SupportsTransactions;
};
成員
__ObjectProviderRegistration類別具有下列類型的成員:
屬性
__ObjectProviderRegistration類別具有這些屬性。
-
InteractionType
-
-
資料類型: sint32
-
存取類型:讀取/寫入
指出類別或執行個體提供者是否提供自己的資料,或依賴 WMI 和 Common Information Model (CIM) 存放庫。 提取提供者支援動態存取其資料,以及推送提供者將其資料儲存在 CIM 存放庫中,並依賴 WMI 來提供其存取權。 如需詳細資訊,請參閱 判斷推送或提取狀態。 預設值是 0 (零)。
-
-
提取 (0)
-
提供者是提取提供者。
-
推送 (1)
-
提供者是推送提供者。
-
PushVerify (2)
-
提供者是推送驗證提供者。 請注意,目前不支援推播驗證。
提供者
-
資料類型: __Provider
-
存取類型:唯讀
表示物件提供者之物件路徑之 __Provider 實例的參考。 此屬性繼承自 __ProviderRegistration。
QuerySupportLevels
-
資料類型: 字串 陣列
-
存取類型:讀取/寫入
查詢處理的提供者內含支援類型的陣列。 類別提供者不支援任何類型的查詢。 如果執行個體提供者不支援查詢處理,可以將 QuerySupportLevels 設定為 Null 。 支援查詢的提供者會實作 IWbemServices::ExecQueryAsync 方法,並將此屬性設定為下列一或多個值, (屬性類型為數組) 。
「WQL:UnarySelect」
「WQL:References」
「WQL:Associators」
「WQL:V1ProviderDefined」
SupportsBatching
-
資料類型: 布林值
-
存取類型:讀取/寫入
未使用。
SupportsDelete
-
資料類型: 布林值
-
存取類型:讀取/寫入
如果 為 True,提供者支援刪除資料。
是
提供者支援類別或實例刪除,方法是實作其中一個 IWbemServices::D eleteClassAsync (類別提供者) 或 IWbemServices::D eleteInstanceAsync (執行個體提供者) 。
否
提供者不支援刪除資料,並從DeleteClassAsync或DeleteInstanceAsync傳回WBEM_E_PROVIDER_NOT_CAPABLE。
SupportsEnumeration
-
資料類型: 布林值
-
存取類型:讀取/寫入
如果 為 True,提供者支援資料列舉。
是
提供者支援資料列舉,方法是實作其中一個 IWbemServices::CreateClassEnumAsync (類別提供者) 或 IWbemServices::CreateInstanceEnumAsync (執行個體提供者) 。
否
提供者不支援資料列舉,並從CreateClassEnumAsync或CreateInstanceEnumAsync傳回WBEM_E_PROVIDER_NOT_CAPABLE。
SupportsGet
-
資料類型: 布林值
-
存取類型:讀取/寫入
如果 為 True,類別或執行個體提供者支援資料擷取。
是
提供者藉由實作 IWbemServices::GetObjectAsync支援資料擷取。
否
提供者不支援資料擷取,並從GetObjectAsync傳回WBEM_E_PROVIDER_NOT_CAPABLE。
SupportsPut
-
資料類型: 布林值
-
存取類型:讀取/寫入
如果 為 True,則類別或執行個體提供者支援資料修改。
是
提供者支援類別或實例修改,方法是實作其中一個 IWbemServices::P utClassAsync (類別提供者) 或 IWbemServices::P utInstanceAsync (類別提供者) 。
否
提供者不支援資料修改,並從PutClassAsync或PutInstanceAsync傳回WBEM_E_PROVIDER_NOT_CAPABLE。
SupportsTransactions
-
資料類型: 布林值
-
存取類型:讀取/寫入
未使用。
備註
__ObjectProviderRegistration類別衍生自__ProviderRegistration。
類別提供者必須將 SupportsEnumeration 屬性設定為 True ,因為提供者必須能夠為其類別清單提供 WMI。 如果類別提供者嘗試將此屬性設定為 False,WMI 會將註冊標示為不合法。 執行個體提供者不需要支援列舉,而且可以選擇將 SupportsEnumeration 設定為 True 或 False。
將 QuerySupportLevels 設定為 「WQL:UnarySelect」 的提供者可以接受包含 WMI 1.0 版所支援之基本 SELECT 語句的查詢。 類別和執行個體提供者都必須能夠處理 __CLASS 系統屬性。 類別提供者也應該處理 __SUPERCLASS 系統屬性和 ISA 運算子。 ISA 運算子可用來將結果集展開為衍生類別。 如果提供者獲得無法解譯的查詢,它會傳回 WBEM_E_TOO_COMPLEX 錯誤值來要求 WMI 處理它。 如需有效 WQL 語法的描述,請參閱 使用 WQL 查詢。
將 QuerySupportLevels 設定為 WQL:V1ProviderDefined 的提供者可以嘗試支援一組較大的 SQL 語法,例如 ORDER BY
子句。 WMI 不會解譯其他子句,或嘗試確保結果集正確無誤。
只有系統管理員可以藉由建立 __Win32Provider 實例並註冊提供者來註冊或刪除提供者。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows Vista |
最低支援的伺服器 |
Windows Server 2008 |
命名空間 |
所有 WMI 命名空間 |