IBindCtx_GetObjectParam

バインドコンテキストの文字列キー付きポインターテーブルで、指定キーに関連付けられたオブジェクトへのインターフェースポインターを取得する。

IBindCtx_GetObjectParam this, pszKey, ppunk

this : [comobj] IBindCtx インターフェースの COM オブジェクト変数
pszKey : [wstr] 検索対象のバインドコンテキスト文字列キー。キー文字列の比較は大文字と小文字を区別する。
ppunk : [int] pszKey に関連付けられたオブジェクトへのインターフェースポインターを受け取る IUnknown* ポインター変数のアドレス。成功時、実装は *ppunk に対して AddRef を呼び出す。Release を呼び出す責任は呼び出し側にある。エラーが発生した場合、実装は *ppunk を NULL に設定する。

(プラグイン / モジュール : com_misc.dll)

解説

バインドコンテキストの文字列キー付きポインターテーブルで、指定キーに関連付けられたオブジェクトへのインターフェースポインターを取得する。

[戻り値]
メソッドが成功した場合、戻り値は S_OK。そうでなければ E_FAIL。

[備考]

バインドコンテキストはインターフェースポインターのテーブルを保持し、それぞれが文字列キーに関連付けられている。これによりモニカ実装とバインド操作を開始した呼び出し側との間で通信が可能になる。このメソッドで取得できるポインターは、事前に
IBindCtx::RegisterObjectParam メソッドを使ってテーブルに挿入されている必要がある。呼び出し側へのメモ
他のオブジェクトを探すためにモニカを使用しているオブジェクトは、バインド操作に失敗したときにこのメソッドを呼び出して発生したエラーの具体的情報を取得できる。エラー内容によっては状況を修正してバインド操作を再試行することも可能である。詳細は
IBindCtx::RegisterObjectParam
を参照。モニカ実装では、呼び出し側がバインド操作を開始して具体的な情報を要求する状況を処理するためにこのメソッドを呼び出すことができる。慣例として、実装者はモニカクラスの
CLSID の文字列形式で始まるキー名を使用するべきである（StringFromCLSID 関数を参照）。

情報