IDataObject::EnumDAdvise 方法 (objidl.h)
创建可用于对当前的通知连接进行枚举的对象。
语法
HRESULT EnumDAdvise(
[out] IEnumSTATDATA **ppenumAdvise
);
参数
[out] ppenumAdvise
指向 IEnumSTATDATA 指针变量的指针,该变量接收指向新枚举器对象的接口指针。 如果实现将 *ppenumAdvise 设置为 NULL,则此时没有连接来建议接收器。
返回值
如果成功实例化枚举器对象或没有连接,此方法将返回S_OK。 其他可能的值包括以下内容。
返回代码 | 说明 |
---|---|
|
可用于操作的内存不足。 |
|
此对象不支持通知。 |
注解
此方法创建的枚举器对象实现 IEnumSTATDATA 接口。 IEnumSTATDATA 允许枚举存储在 STATDATA 结构数组中的数据。 其中每个结构都提供有关单个咨询连接的信息,包括 FORMATETC 和 ADVF 信息,以及指向建议接收器和表示连接的令牌的指针。
调用方备注
建议使用 OLE 数据建议持有者对象来处理咨询连接。 通过调用 CreateDataAdviseHolder 获取指针后,实现 IDataObject::EnumDAdvise 成为委托对 IDataAdviseHolder::EnumAdvise 的调用的简单问题。 这将创建枚举器并提供指向 IEnumSTATDATA 的 OLE 实现的指针。 此时,可以调用其方法来枚举当前通知连接。要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | objidl.h |