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 接口指针，该指针提供对该表的访问权限。

名字对象提供程序应调用 GetRunningObjectTable，这些名字对象提供程序会分发标识对象，以便其他人能够访问它们。 使用此函数返回的接口指针在对象开始运行时注册对象，记录这些对象的修改时间，并在这些对象停止运行时撤消其注册。 有关详细信息，请参阅 IRunningObjectTable 接口。

复合文档链接源是名字对象提供程序的最常见示例。 其中包括支持链接到文档的服务器应用程序 (文档或文档) 部分，以及支持链接到文档中嵌入的容器应用程序。 不支持链接的服务器应用程序还可以使用 ROT 与支持链接到嵌入的容器应用程序合作。

如果要实现 IMoniker 接口以编写新的名字对象类，并且需要指向 ROT 的接口指针，请调用 IBindCtx：：GetRunningObjectTable ，而不是 GetRunningObjectTable 函数。 这样 ，IBindCtx 接口的未来实现就可以修改绑定行为。

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 objbase.h
Library Ole32.lib
DLL Ole32.dll
API 集 在 Windows 8) 中引入的 ext-ms-win-com-ole32-l1-1-0 (

另请参阅

IBindCtx：：GetRunningObjectTable

IMoniker

IRunningObjectTable