Provider::GetObject (CInstance*,long,CFrameworkQuery&) 方法 (provider.h)
[ Provider 類別是 WMI 提供者架構的一部分,現在被視為最終狀態,而且不會影響這些連結庫的非安全性相關問題不會有進一步的開發、增強功能或更新。 MI API 應該用於所有新的開發。]
WMI 會呼叫 GetObject 方法,以擷取類別的實例。
語法
HRESULT GetObject(
CInstance *pInstance,
[ref] long lFlags,
CFrameworkQuery & Query
);
參數
pInstance
TBD
[ref] lFlags
查詢物件,指出要填入的屬性集,如 呼叫 Provider::GetObject 所要求。
提供者只要填入這些要求的屬性值,即可實現顯著的效能提升。 提供者會決定使用 CFrameworkQuery::IsPropertyRequired 來要求哪些屬性。 否則,提供者必須填入所有屬性值。
Query
TBD
傳回值
這個方法的默認架構提供者實作會將 WBEM_E_PROVIDER_NOT_CAPABLE 傳回給呼叫方法。 IWbemServices::GetObject 方法會列出常見的傳回值,不過您可以選擇實作任何 COM 傳回值。
備註
WMI 通常會叫用 GetObject ,以回應 IWbemServices::GetObject 的用戶端呼叫。 Provider::GetObject 的 WMI 版本只提供已填入索引鍵屬性的實例。 相反地,實作的架構提供者必須填入所有其他屬性。 下列描述 GetObject 的常見覆寫:
- 使用 CInstance 的 Get 方法讀取索引鍵屬性,例如 CInstance::GetCHString,以判斷所要求哪些實例 WMI。
- 使用 CInstance 類別的許多 Set 方法填入實例的其餘屬性,例如 CInstance::SetByte 或 CInstance::SetStringArray。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista |
最低支援的伺服器 | Windows Server 2008 |
目標平台 | Windows |
標頭 | provider.h (include FwCommon.h) |
程式庫 | FrameDyn.lib |
Dll | FrameDynOS.dll;FrameDyn.dll |