CWbemProviderGlue::GetAllInstances メソッド (wbemglue.h)
[CWbemProviderGlue クラスは WMI プロバイダー フレームワークの一部であり、現在最終的な状態と見なされています。これらのライブラリに影響を与える、セキュリティ関連以外の問題に対しては、それ以上の開発、機能強化、または更新プログラムは利用できません。 すべての新規開発には、MI API を使用する必要があります。]
GetAllInstances メソッドは、特定のクラスによって返されるインスタンスの一覧を取得します。
構文
HRESULT GetAllInstances(
LPCWSTR pszClassName,
TRefPointerCollection<CInstance> *pList,
LPCWSTR pszNamespace,
MethodContext *pMethodContext
);
パラメーター
pszClassName
インスタンスの一覧を返すクラスの名前。
pList
pszClassName で指定されたプロバイダーでサポートされているインスタンスのリンクされた一覧。
pszNamespace
pszClassName で指定されたプロバイダーの名前空間。 このパラメーターは、"Root\CIMv2" である既定の名前空間を示す NULL にすることができます 。
pMethodContext
現在のコンテキストへのポインター。 デッドロックを防ぐためにコンテキストを指定する必要があります。 Provider::EnumerateInstances または Provider::ExecQuery によってプロバイダーに渡されたコンテキストを使用するか、CInstance::GetMethodContext を使用してインスタンスから取得します。 このパラメーターは NULL にすることはできません。
戻り値
メソッドは、操作が成功した場合は WBEM_S_NO_ERROR を返し、メモリ不足のために操作が失敗した場合は WBEM_E_OUT_OF_MEMORY 、またはその他の HRESULT エラー コードが返されます。
注釈
GetAllInstances メソッドを使用すると、フレームワーク プロバイダーは WMI API 呼び出しを行うことなく、別のプロバイダーからデータにアクセスできます。 フレームワーク プロバイダーは、プロバイダーの名前を GetAllInstances に渡します。この名前は、プロバイダーがサポートするすべてのインスタンスの一覧を返します。
このメソッドは、SELECT * FROM pszBaseClassName WHERE __Class = pszBaseClassName というクエリと意味的に同等 です。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista |
サポートされている最小のサーバー | Windows Server 2008 |
対象プラットフォーム | Windows |
ヘッダー | wbemglue.h (FwCommon.h を含む) |
Library | FrameDyn.lib |
[DLL] | FrameDynOS.dll;FrameDyn.dll |