IOleAdviseHolder::EnumAdvise 方法 (oleidl.h)
创建可用于枚举当前为对象建立的咨询连接的枚举器。
语法
HRESULT EnumAdvise(
[out] IEnumSTATDATA **ppenumAdvise
);
参数
[out] ppenumAdvise
指向 IEnumSTATDATA 指针变量的指针,该变量接收指向新枚举器的接口指针。 如果此参数为 NULL,则表示对象上当前没有咨询连接,或发生错误。 建议持有者负责递增此方法提供的 IEnumSTATDATA 指针上的引用计数。 调用方负责在完成指针时调用 IUnknown::Release 。
返回值
此方法在成功时返回S_OK。 其他可能的返回值包括以下内容。
返回代码 | 说明 |
---|---|
|
枚举操作失败。 |
|
注解
IOleAdviseHolder::EnumAdvise 创建可用于枚举对象的已建立咨询连接的枚举器。 方法提供指向此枚举器上的 IEnumSTATDATA 接口的指针。 每个连接的咨询连接信息存储在 STATDATA 结构中,枚举器必须能够枚举这些结构。
对于此方法,唯一相关的结构成员是 pAdvise 和 dwConnection。 其他成员包含数据咨询信息。 调用枚举方法时,当枚举正在进行时,注册或撤消咨询连接对要枚举的内容的影响是未定义的。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | oleidl.h |