CWbemProviderGlue::GetInstancesByQuery(LPCWSTR,TRefPointerCollection<CInstance>*,MethodContext*,LPCWSTR) メソッド (wbemglue.h)

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

GetInstancesByQuery メソッドは、特定のクエリに一致するインスタンスの一覧を取得します。

構文

HRESULT GetInstancesByQuery(
  LPCWSTR                          query,
  TRefPointerCollection<CInstance> *pList,
  MethodContext                    *pMethodContext,
  LPCWSTR                          pszNamespace
);

パラメーター

query

実行するクエリ。

pList

Query で指定されたクエリと一致するインスタンスのリンクされたリスト。

pMethodContext

現在のコンテキストへのポインター。 デッドロックを防ぐためにコンテキストを指定する必要があります。 Provider::EnumerateInstances または Provider::ExecQuery によってプロバイダーに渡されたコンテキストを使用するか、CInstance::GetMethodContext を使用してインスタンスから取得します。 このパラメーターは NULL にすることはできません。

pszNamespace

インスタンスを含む名前空間へのポインター。 NULL の場合、既定の名前空間であるルート\cimv2 が使用されます。

戻り値

メソッドは、操作が成功した場合は WBEM_S_NO_ERROR 、操作が失敗した場合 はWBEM_E_FAILED 、その他 の HRESULT エラー コードを返します。

注釈

GetInstancesByQuery メソッドを使用すると、フレームワーク プロバイダーは WMI API 呼び出しを行うことなく、他のプロバイダーからデータにアクセスできます。 フレームワーク プロバイダーは、適切なインスタンスを返す GetInstancesByQuery にクエリを渡します。

パフォーマンス上の理由から、この関数を呼び出すときは、必要なプロパティのみを指定します (たとえば、"SELECT *" ではなく "SELECT name" を指定します)。

要件

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