共用方式為


GetRunningObjectTable 函式 (objbase.h)

傳回本機執行對象數據表上 IRunningObjectTable 介面的指標, (ROT) 。

語法

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

參數

[in] reserved

此參數是保留的,而且必須是 0。

[out] pprot

接收本機 ROT 介面指標的 IRunningObjectTable* 指標變數位址。 函式成功時,呼叫端會負責在介面指標上呼叫 Release 。 如果發生錯誤,*pprot 未定義。

傳回值

此函式可以傳回標準傳回值E_UNEXPECTED和S_OK。

備註

每個工作站都有一個本機 ROT,可維護已在該電腦上註冊為執行的對象數據表。 此函式會傳回 IRunningObjectTable 介面指標,此指標可提供該數據表的存取權。

Moniker 提供者會傳出識別物件的Moniker,讓其他人能夠存取它們,應該呼叫 GetRunningObjectTable。 使用此函式傳回的介面指標,在對象開始執行時註冊您的對象、記錄這些物件的修改時間,以及在停止執行時撤銷其註冊。 如需詳細資訊,請參閱 IRunningObjectTable 介面。

複合文件連結來源是Moniker提供者最常見的範例。 其中包括支援連結至其檔案的伺服器應用程式 (或檔案) 部分,以及支持連結至其檔案內嵌的容器應用程式。 不支援連結的伺服器應用程式也可以使用 ROT 來與支援連結至內嵌的容器應用程式合作。

如果您要實作 IMoniker 介面來撰寫新的 Moniker 類別,而且您需要 ROT 的介面指標,請呼叫 IBindCtx::GetRunningObjectTable,而不是 GetRunningObjectTable 函式。 這可讓 IBindCtx 介面的未來實作修改系結行為。

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 objbase.h
程式庫 Ole32.lib
Dll Ole32.dll
API 集合 ext-ms-win-com-ole32-l1-1-0 (於 Windows 8)

另請參閱

IBindCtx::GetRunningObjectTable

IMoniker

IRunningObjectTable