IBindCtx_RegisterObjectParam

バインドコンテキストの文字列キー付きポインターテーブルで、オブジェクトを文字列キーに関連付ける。

IBindCtx_RegisterObjectParam this, pszKey, punk

this : [comobj] IBindCtx インターフェースの COM オブジェクト変数
pszKey : [wstr] オブジェクトを登録するバインドコンテキスト文字列キー。キー文字列の比較は大文字と小文字を区別する。
punk : [int] 登録するオブジェクトの IUnknown インターフェースへのポインター。メソッドはこのポインターに対して AddRef を呼び出す。

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

解説

バインドコンテキストの文字列キー付きポインターテーブルで、オブジェクトを文字列キーに関連付ける。

[戻り値]
このメソッドは標準の戻り値 E_OUTOFMEMORY および S_OK を返すことがある。

[備考]

バインドコンテキストはインターフェースポインターのテーブルを保持し、それぞれが文字列キーに関連付けられている。これによりモニカ実装とバインド操作を開始した呼び出し側との間で通信が可能になる。一方がインターフェースポインターを双方で既知の文字列で格納しておけば、もう一方が後でバインドコンテキストから取り出すことができる。このメソッドを使用した後のバインド操作は
IBindCtx::GetObjectParam を使って格納されたポインターを取得できる。呼び出し側へのメモ
RegisterObjectParam は新しいモニカクラスを実装する側（IMoniker
の実装を通じて）とモニカクライアント（モニカを使ってオブジェクトへバインドする側）の双方に有用である。新しいモニカクラスを実装する際、モニカバインド中にエラーが発生した場合にエラーの原因を呼び出し側に通知するためにこのメソッドを呼び出す。このメソッドで使用するキーはエラー条件に依存する。以下によくあるモニカバインドエラーと、それぞれに適したキーを挙げる。
（以下省略）

情報