次の方法で共有

Provider::GetObject(ParsedObjectPath*,MethodContext*,long) メソッド (provider.h)

  • [アーティクル]

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

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

構文

HRESULT GetObject(
        ParsedObjectPath *pParsedObjectPath,
        MethodContext    *pContext,
  [ref] long             lFlags
);

パラメーター

pParsedObjectPath

フレームワーク プロバイダーによって入力される CInstance オブジェクトへのポインター。

pContext

GetObject 操作に関する情報を含むフラグのビットマスク。 これは、 IWbemServices::GetObject メソッドでクライアントによって指定された値です。

次のフラグは、WMI によって処理 (およびフィルター処理) されます。

  • WBEM_FLAG_USE_AMENDED_QUALIFIERS
  • WBEM_FLAG_RETURN_WBEM_COMPLETE
  • WBEM_FLAG_RETURN_IMMEDIATELY

[ref] lFlags

Provider::GetObject の呼び出しによって要求された、設定するプロパティのセットを示すクエリ オブジェクト。

プロバイダーは、これらの要求されたプロパティ値のみを入力することで、大幅なパフォーマンス向上を実現できます。 プロバイダーは、 CFrameworkQuery::IsPropertyRequired を使用して要求されるプロパティを決定します。 それ以外の場合、プロバイダーはすべてのプロパティ値を入力する必要があります。

戻り値

このメソッドの既定のフレームワーク プロバイダーの実装では、呼び出し元のメソッドに 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 メソッドを使用して、インスタンスの残りのプロパティを設定します。

要件

要件 値
サポートされている最小のクライアント Windows Vista
サポートされている最小のサーバー Windows Server 2008
対象プラットフォーム Windows
ヘッダー provider.h (FwCommon.h を含む)
Library FrameDyn.lib
[DLL] FrameDynOS.dll;FrameDyn.dll