CWbemProviderGlue::GetInstancePropertiesByPath メソッド (wbemglue.h)
[CWbemProviderGlue クラスは WMI プロバイダー フレームワークの一部であり、現在最終的な状態と見なされています。これらのライブラリに影響を与える、セキュリティ関連以外の問題に対しては、それ以上の開発、機能強化、または更新プログラムは利用できません。 すべての新規開発には、MI API を使用する必要があります。]
GetInstancePropertiesByPath メソッドは、指定されたプロパティのみが設定された特定のオブジェクト パスによって識別されるインスタンスを取得します。 設定するプロパティの名前は 、CHString 配列内にあります。
構文
HRESULT GetInstancePropertiesByPath(
LPCWSTR pszInstancePath,
CInstance **ppInstance,
MethodContext *pMethodContext,
[ref] CHStringArray & csaProperties
);
パラメーター
pszInstancePath
返されるインスタンスへのオブジェクト パス。 このパラメーターは、完全なパスを指す必要があります。
ppInstance
pszInstancePath で指定されたキーを持つ新しい CInstance インスタンスへのポインターへのポインター。 要求を実行するフレームワーク プロバイダーは、このポインターを解放する必要があります。
pMethodContext
現在のコンテキストへのポインター。 デッドロックを防ぐためにコンテキストを指定する必要があります。 Provider::EnumerateInstances または Provider::ExecQuery によってプロバイダーに渡されたコンテキストを使用するか、CInstance::GetMethodContext を使用してインスタンスから取得します。 このパラメーターは NULL にすることはできません。
[ref] csaProperties
新しいインスタンスにコピーするプロパティの名前を含む配列。
戻り値
操作が成功した場合 はWBEM_S_NO_ERROR を返し、メモリ不足が原因で操作が失敗した場合は WBEM_E_OUT_OF_MEMORY 、その他の HRESULT エラー コードを返します。
注釈
このメソッドは、部分インスタンス更新操作を使用して、指定したオブジェクトの指定したプロパティのみを要求します。 これは、キーよりも多くのプロパティが必要な場合に、特定のインスタンスを取得する最も効率的な方法です。 すべてのプロバイダーが部分インスタンス操作をサポートしているわけではないことに注意してください。 その場合、インスタンス全体 (キーを含む) が設定されます。 詳細については、「 Partial-Instance 操作のサポート」を参照してください。
プロバイダー フレームワークの現在のバージョンでは、 pszInstancePath が同じコンピューター上のインスタンス パスに解決される必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | wbemglue.h (FwCommon.h を含む) |
| Library | FrameDyn.lib |
| [DLL] | FrameDynOS.dll;FrameDyn.dll |