GetRunningObjectTable 関数 (objbase.h)

  • [アーティクル]

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

構文

HRESULT GetRunningObjectTable(
  [in]  DWORD                reserved,
  [out] LPRUNNINGOBJECTTABLE *pprot
);

パラメーター

[in] reserved

このパラメーターは予約済みであり、0 である必要があります。

[out] pprot

ローカル ROT へのインターフェイス ポインターを受け取る IRunningObjectTable* ポインター変数のアドレス。 関数が成功すると、呼び出し元はインターフェイス ポインターで Release を呼び出す必要があります。 エラーが発生した場合、*pprot は未定義です。

戻り値

この関数は、E_UNEXPECTEDおよびS_OKの標準戻り値を返すことができます。

注釈

各ワークステーションには、そのコンピューターで実行中として登録されているオブジェクトのテーブルを保持するローカル ROT があります。 この関数は、そのテーブルへのアクセスを提供する IRunningObjectTable インターフェイス ポインターを返します。

他のユーザーがアクセスできるようにオブジェクトを識別するモニカーを配布するモニカー プロバイダーは、 GetRunningObjectTable を呼び出す必要があります。 この関数によって返されるインターフェイス ポインターを使用して、オブジェクトの実行時にオブジェクトを登録し、それらのオブジェクトが変更された時間を記録し、実行を停止したときに登録を取り消します。 詳細については、 IRunningObjectTable インターフェイスを参照してください。

複合ドキュメント リンク ソースは、モニカー プロバイダーの最も一般的な例です。 これには、ドキュメントへのリンクをサポートするサーバー アプリケーション (またはドキュメントの一部) や、ドキュメント内の埋め込みへのリンクをサポートするコンテナー アプリケーションが含まれます。 リンクをサポートしていないサーバー アプリケーションでは、ROT を使用して、埋め込みへのリンクをサポートするコンテナー アプリケーションと連携することもできます。

IMoniker インターフェイスを実装して新しいモニカー クラスを作成し、ROT へのインターフェイス ポインターが必要な場合は、GetRunningObjectTable 関数ではなく IBindCtx::GetRunningObjectTable を呼び出します。 これにより、 IBindCtx インターフェイスの今後の実装でバインディングの動作を変更できます。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー objbase.h
Library Ole32.lib
[DLL] Ole32.dll
API セット ext-ms-win-com-ole32-l1-1-0 (Windows 8で導入)

こちらもご覧ください

IBindCtx::GetRunningObjectTable

Imoniker

IRunningObjectTable