CWbemProviderGlue::GetInstanceKeysByPath メソッド (wbemglue.h)
[CWbemProviderGlue クラスは WMI プロバイダー フレームワークの一部であり、現在最終的な状態と見なされています。これらのライブラリに影響を与える、セキュリティ関連以外の問題に対しては、それ以上の開発、機能強化、または更新プログラムは利用できません。 すべての新規開発には、MI API を使用する必要があります。]
GetInstanceKeysByPath メソッドは、キー プロパティのみが設定された特定のオブジェクト パスによって識別されるインスタンスを取得します。
構文
HRESULT GetInstanceKeysByPath(
LPCWSTR pszInstancePath,
CInstance **ppInstance,
MethodContext *pMethodContext
);
パラメーター
pszInstancePath
返されるインスタンスへのオブジェクト パス。
ppInstance
pszInstancePath で指定されたキーを持つ新しい CInstance インスタンスへのポインター。 要求を実行するフレームワーク プロバイダーは、このポインターを解放する必要があります。
pMethodContext
現在のコンテキストへのポインター。 デッドロックを防ぐためにコンテキストを指定する必要があります。 Provider::EnumerateInstances または Provider::ExecQuery によってプロバイダーに渡されたコンテキストを使用するか、CInstance::GetMethodContext を使用してインスタンスから取得します。 このパラメーターは NULL にすることはできません。
戻り値
操作が成功した場合は 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 |