IRunningObjectTable::Revoke 方法 (objidl.h)

从运行的对象表中删除一个条目, (ROT) 之前通过调用 IRunningObjectTable::Register 注册。

语法

HRESULT Revoke(
  [in] DWORD dwRegister
);

参数

[in] dwRegister

要撤销的 ROT 条目的标识符。

返回值

此方法可以返回E_INVALIDARG和S_OK的标准返回值。

注解

此方法取消调用 IRunningObjectTable::Register 的效果,删除名字对象和指向该名字对象所标识的对象的指针。

给调用方的说明

名字对象提供程序 (传出标识其对象的名称对象,使其他人能够访问这些对象) 必须在停止运行时调用 Revoke 方法来撤销其对象的注册。 它必须以前调用 IRunningObjectTable::Register 并存储该方法返回的标识符;它在调用 Revoke 时使用该标识符。

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

如果要编写容器应用程序,则必须在文档关闭时撤销文档的注册。 在重命名文档时重新注册文档之前,还必须撤销文档的注册。

如果要编写服务器应用程序,则必须在关闭对象时撤消对象的注册。 在重命名对象的容器文档之前,还必须撤销对象的注册, (请参阅 IOleObject::SetMoniker) 。

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 objidl.h

另请参阅

IRunningObjectTable