IOleObject：：EnumAdvise 方法 (oleidl.h)

  • 项目

检索指向枚举器的指针，该枚举器可用于枚举为 对象注册的咨询连接，以便容器可以在关闭之前知道要释放的内容。

语法

HRESULT EnumAdvise(
  [out] IEnumSTATDATA **ppenumAdvise
);

参数

[out] ppenumAdvise

接收指向枚举器对象的接口指针的 IEnumSTATDATA 指针变量的地址。 如果对象没有任何建议连接或发生错误，则实现必须将 ppenumAdvise 设置为 NULL。 每次对象成功接收对 IOleObject：：EnumAdvise 的调用时，它都必须增加 ppenumAdvise 上的引用计数。 调用方负责在使用 ppenumAdvise 时调用 Release。

返回值

此方法在成功时返回S_OK。 其他可能的返回值包括以下内容。

返回代码 说明
E_NOTIMPL

未实现 IOleObject：：EnumAdvise 。

注解

IOleObject：：EnumAdvise 方法提供一个枚举器，该枚举器为容器提供一种方法来跟踪为其对象注册的咨询连接。 容器通常会调用此函数，以便它可以指示对象在关闭之前释放其每个建议连接。

通过 IOleObject：：EnumAdvise 访问的枚举器枚举 STATDATA 类型的项。 收到指针后，容器可以循环访问 STATDATA ，并为每个枚举连接调用 IOleObject：：Unadvise 。

实现此函数的常用方法是将调用委托给 IOleAdviseHolder 接口。 只有 STATDATA 的 pAdvise 和 dwConnection 成员与 IOleObject：：EnumAdvise 相关。

要求

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

另请参阅

IOleObject

IOleObject：：Advise

IOleObject：：Unadvise