共用方式為


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 的常見覆寫:

  1. 使用 CInstanceGet 方法讀取索引鍵屬性,例如 CInstance::GetCHString,以判斷所要求哪些實例 WMI。
  2. 使用 CInstance 類別的許多 Set 方法填入實例的其餘屬性,例如 CInstance::SetByteCInstance::SetStringArray

規格需求

需求
最低支援的用戶端 Windows Vista
最低支援的伺服器 Windows Server 2008
目標平台 Windows
標頭 provider.h (include FwCommon.h)
程式庫 FrameDyn.lib
Dll FrameDynOS.dll;FrameDyn.dll