Provider::GetObject(CInstance*,long,CFrameworkQuery&) メソッド (provider.h)

[Provider クラスは WMI プロバイダー フレームワークの一部であり、現在最終的な状態と見なされています。これらのライブラリに影響を与える、セキュリティ関連以外の問題に対しては、それ以上の開発、機能強化、または更新プログラムは利用できません。 すべての新規開発には、MI API を使用する必要があります。]

GetObject メソッドは、クラスのインスタンスを取得するために WMI によって呼び出されます。

構文

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 は多くの場合、IWbemServices::GetObject へのクライアント呼び出しに応答して GetObject を呼び出します。 PROVIDER::GetObject の WMI バージョンでは、キー プロパティのみが設定されたインスタンスが提供されます。 これに対し、実装されたフレームワーク プロバイダーは、他のすべてのプロパティを入力する必要があります。 GetObject の一般的なオーバーライドを次に示 します。

1. CInstance::GetCHString など、CInstance から Get メソッドを使用してキー プロパティを読み取ることによって要求されたインスタンス WMI を決定します。
2. CInstance::SetByte や CInstance::SetStringArray など、CInstance クラスの多くの Set メソッドを使用して、インスタンスの残りのプロパティを設定します。

要件