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) |