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