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