IBindCtx::GetObjectParam メソッド (objidl.h)
バインド コンテキストの文字列キー付きポインター テーブルで、指定したキーに関連付けられているオブジェクトへのインターフェイス ポインターを取得します。
構文
HRESULT GetObjectParam(
[in] LPOLESTR pszKey,
[out] IUnknown **ppunk
);
パラメーター
[in] pszKey
検索する バインド コンテキスト文字列キー 。 キー文字列の比較では、大文字と小文字が区別されます。
[out] ppunk
pszKey に関連付けられているオブジェクトへのインターフェイス ポインターを受け取る IUnknown* ポインター変数のアドレス。 成功した場合、実装は *ppunk で AddRef を呼び出します。 Release を呼び出すのは呼び出し元の責任です。 エラーが発生した場合、実装は *ppunk を NULL に設定 します。
戻り値
メソッドが成功した場合、戻り値はS_OK。 それ以外の場合は、E_FAIL。
注釈
バインド コンテキストは、それぞれ文字列キーに関連付けられたインターフェイス ポインターのテーブルを保持します。 これにより、モニカー実装とバインディング操作を開始した呼び出し元との間の通信が可能になります。 一方のパーティは、後でバインド コンテキストから取得できるように、両方のパーティに認識されている文字列の下にインターフェイス ポインターを格納できます。
このメソッドが取得するポインターは、 以前に IBindCtx::RegisterObjectParam メソッドを使用してテーブルに挿入されている必要があります。
呼び出し元へのメモ
モニカーを使用して他のオブジェクトを検索するオブジェクトは、バインド操作で発生したエラーに関する特定の情報を取得できない場合に、このメソッドを呼び出すことができます。 エラーによっては、状況を修正し、バインド操作を再試行できる場合があります。 詳細については、「 IBindCtx::RegisterObjectParam 」を参照してください。モニカーの実装では、このメソッドを呼び出して、呼び出し元がバインド操作を開始し、特定の情報を要求する状況を処理できます。 慣例により、実装者はモニカー クラスの CLSID の文字列形式で始まるキー名を使用する必要があります。 ( StringFromCLSID 関数を参照してください)。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | objidl.h |