IBindCtx_GetRunningObjectTable

このバインドコンテキストが動作しているコンピューターのランニングオブジェクトテーブル (ROT) へのインターフェースポインターを取得する。

IBindCtx_GetRunningObjectTable this, pprot

this : [comobj] IBindCtx インターフェースの COM オブジェクト変数
pprot : [comobj] ランニングオブジェクトテーブルへのインターフェースポインターを受け取る IRunningObjectTable* ポインター変数のアドレス。エラーが発生した場合 *pprot は NULL に設定される。*pprot が非 NULL の場合、実装はランニングテーブルオブジェクトに対して AddRef を呼び出す。Release を呼び出す責任は呼び出し側にある。

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

解説

このバインドコンテキストが動作しているコンピューターのランニングオブジェクトテーブル (ROT)
へのインターフェースポインターを取得する。

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

[備考]
ランニングオブジェクトテーブル (ROT)
は各コンピューター上でグローバルにアクセス可能なテーブルで、現在実行中のオブジェクトをすべて追跡する。呼び出し側へのメモ
通常、新しいモニカクラスを実装する側（IMoniker
の実装を通じて）がこのメソッドを呼び出す。IMoniker::BindToObject や IMoniker::IsRunning
の実装内でオブジェクトが現在実行中かどうかを確認するのに便利である。また IMoniker::GetTimeOfLastChange
の実装内で、実行中オブジェクトが最後に変更された時刻を取得するためにも利用できる。モニカ実装では
GetRunningObjectTable 関数を使わずにこのメソッドを呼び出すべきである。これにより将来の IBindCtx
実装がバインド動作を変更する余地が残る。

情報