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 接口。 只有 STATDATApAdvisedwConnection 成员与 IOleObject::EnumAdvise 相关。

要求

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

另请参阅

IOleObject

IOleObject::Advise

IOleObject::Unadvise