GetRunningObjectTable

ローカルの実行中オブジェクトテーブル（ROT）上の IRunningObjectTable インターフェイスへのポインタを返す。

GetRunningObjectTable reserved, pprot

reserved : [int] このパラメータは予約済みであり、0 を指定しなければならない。
pprot : [var] ローカル ROT へのインターフェイスポインタを受け取る IRunningObjectTable* ポインタ変数のアドレス。関数が成功した場合、呼び出し側はインターフェイスポインタに対して Release を呼び出す責任を負う。エラーが発生した場合、*pprot の値は未定義となる。

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

解説

ローカルの実行中オブジェクトテーブル（ROT）上の IRunningObjectTable インターフェイスへのポインタを返す。

[戻り値]
この関数は標準の戻り値 E_UNEXPECTED および S_OK を返すことがある。

[備考]
各ワークステーションにはローカル ROT
があり、そのコンピュータ上で実行中として登録されたオブジェクトのテーブルを管理している。この関数は IRunningObjectTable
インターフェイスポインタを返し、それによりテーブルへのアクセスが可能となる。他者からアクセスできるようオブジェクトを識別するモニカを配布するモニカプロバイダは、GetRunningObjectTable
を呼び出すべきである。この関数が返すインターフェイスポインタを使用して、オブジェクトの実行開始時に登録を行い、オブジェクトが変更された時刻を記録し、実行終了時に登録を取り消すこと。詳細は
IRunningObjectTable インターフェイスを参照。

複合ドキュメントのリンク元は、モニカプロバイダのもっとも一般的な例である。これには、ドキュメント（またはドキュメントの一部）へのリンクをサポートするサーバーアプリケーション、およびドキュメント内の埋め込みオブジェクトへのリンクをサポートするコンテナアプリケーションが含まれる。リンクをサポートしないサーバーアプリケーションも、埋め込みへのリンクをサポートするコンテナアプリケーションと協調するために
ROT を使用できる。新しいモニカクラスを記述するために IMoniker インターフェイスを実装しており、ROT
へのインターフェイスポインタが必要な場合、GetRunningObjectTable 関数ではなく
IBindCtx::GetRunningObjectTable を呼び出すこと。これにより、IBindCtx
インターフェイスの将来の実装でバインド動作を変更できるようになる。

情報