IOleObject::EnumAdvise 方法 (oleidl.h)
检索指向枚举器的指针,该枚举器可用于枚举为 对象注册的咨询连接,以便容器可以在关闭之前知道要释放的内容。
语法
HRESULT EnumAdvise(
[out] IEnumSTATDATA **ppenumAdvise
);
参数
[out] ppenumAdvise
接收指向枚举器对象的接口指针的 IEnumSTATDATA 指针变量的地址。 如果对象没有任何建议连接或发生错误,则实现必须将 ppenumAdvise 设置为 NULL。 每次对象成功接收对 IOleObject::EnumAdvise 的调用时,它都必须增加 ppenumAdvise 上的引用计数。 调用方负责在使用 ppenumAdvise 时调用 Release。
返回值
此方法在成功时返回S_OK。 其他可能的返回值包括以下内容。
返回代码 | 说明 |
---|---|
|
注解
IOleObject::EnumAdvise 方法提供一个枚举器,该枚举器为容器提供一种方法来跟踪为其对象注册的咨询连接。 容器通常会调用此函数,以便它可以指示对象在关闭之前释放其每个建议连接。
通过 IOleObject::EnumAdvise 访问的枚举器枚举 STATDATA 类型的项。 收到指针后,容器可以循环访问 STATDATA ,并为每个枚举连接调用 IOleObject::Unadvise 。
实现此函数的常用方法是将调用委托给 IOleAdviseHolder 接口。 只有 STATDATA 的 pAdvise 和 dwConnection 成员与 IOleObject::EnumAdvise 相关。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | oleidl.h |