IBindCtx_RegisterObjectBound

バインドコンテキストが解放されるまでオブジェクトがアクティブのまま保たれるよう、そのオブジェクトをバインドコンテキストに登録する。

IBindCtx_RegisterObjectBound this, punk

this : [comobj] IBindCtx インターフェースの COM オブジェクト変数
punk : [int] バインド済みとして登録するオブジェクトの IUnknown インターフェースへのポインター。

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

解説

バインドコンテキストが解放されるまでオブジェクトがアクティブのまま保たれるよう、そのオブジェクトをバインドコンテキストに登録する。

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

[備考]
新しいモニカクラスを作成する場合（IMoniker
インターフェースの実装を通じて）、実装がオブジェクトをアクティブ化したときは常にこのメソッドを呼び出すべきである。これはモニカのバインド過程で最もよく発生するが、モニカの表示名の取得、表示名からモニカへの解析、オブジェクトの最終変更時刻の取得中にも起こり得る。RegisterObjectBound
はオブジェクトに対する追加の参照を作成するために AddRef
を呼び出す。ただし自身のポインターは別途解放する必要がある。同じオブジェクトに対してこのメソッドを 2
回呼び出すと、そのオブジェクトへの参照が 2 つ作成される。このメソッドの呼び出しで取得した参照は
IBindCtx::RevokeObjectBound
を呼び出して解放できる。バインドコンテキスト自身が解放されると、そのバインドコンテキストが保持していたすべての参照が解放される。RegisterObjectBound
でオブジェクトをバインドコンテキストに登録すると、バインドコンテキストが解放されるまでそのオブジェクトはアクティブ状態に保たれる。同じバインドコンテキストを後続のバインド操作で（同じ複合モニカの別の部分に対して、あるいは異なるモニカに対して）再利用すると、そのオブジェクトを再読み込みする必要がなくなるためバインド操作を効率化できる。ただしこれは後続のバインド操作が元の操作と同じオブジェクトを必要とする場合にのみ性能向上につながるため、バインドコンテキスト再利用による性能向上と不要にオブジェクトをアクティブのまま保持するコストを比較検討する必要がある。
IBindCtx は RegisterObjectBound
で登録されたオブジェクトへのポインターを取得するメソッドを提供しない。オブジェクトがランニングオブジェクトテーブルに自身を登録していれば、モニカ実装は
IRunningObjectTable::GetObject を呼び出してオブジェクトへのポインターを取得できる。

情報