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で導入) |