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. 使用 CInstance 的 Get 方法讀取索引鍵屬性，例如 CInstance：：GetCHString，以判斷所要求哪些實例 WMI。
  2. 使用 CInstance 類別的許多 Set 方法填入實例的其餘屬性，例如 CInstance：：SetByte 或 CInstance：：SetStringArray。

規格需求

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