IDataObject::EnumDAdvise 方法 (objidl.h)

创建可用于对当前的通知连接进行枚举的对象。

语法

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

参数

[out] ppenumAdvise

指向 IEnumSTATDATA 指针变量的指针,该变量接收指向新枚举器对象的接口指针。 如果实现将 *ppenumAdvise 设置为 NULL,则此时没有连接来建议接收器。

返回值

如果成功实例化枚举器对象或没有连接,此方法将返回S_OK。 其他可能的值包括以下内容。

返回代码 说明
E_OUTOFMEMORY
可用于操作的内存不足。
OLE_E_ADVISENOTSUPPORTED
此对象不支持通知。

注解

此方法创建的枚举器对象实现 IEnumSTATDATA 接口。 IEnumSTATDATA 允许枚举存储在 STATDATA 结构数组中的数据。 其中每个结构都提供有关单个咨询连接的信息,包括 FORMATETCADVF 信息,以及指向建议接收器和表示连接的令牌的指针。

调用方备注

建议使用 OLE 数据建议持有者对象来处理咨询连接。 通过调用 CreateDataAdviseHolder 获取指针后,实现 IDataObject::EnumDAdvise 成为委托对 IDataAdviseHolder::EnumAdvise 的调用的简单问题。 这将创建枚举器并提供指向 IEnumSTATDATA 的 OLE 实现的指针。 此时,可以调用其方法来枚举当前通知连接。

要求

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

另请参阅

IDataAdviseHolder::EnumAdvise

IDataObject

IEnumSTATDATA