IConnectionPointContainer::EnumConnectionPoints 方法 (ocidl.h)

创建枚举器对象以循环访问可连接对象中支持的所有连接点,每个传出 IID 一个连接点。

语法

HRESULT EnumConnectionPoints(
  [out] IEnumConnectionPoints **ppEnum
);

参数

[out] ppEnum

指向 IEnumConnectionPoints 接口指针变量的指针,该指针接收指向新创建的枚举器的指针。

返回值

此方法可以返回E_OUTOFMEMORY和E_UNEXPECTED的标准返回值,以及以下值。

返回代码 说明
S_OK
已成功创建枚举器对象。
E_POINTER
ppEnum 中的地址无效。 例如,它可能为 NULL

注解

由于 IEnumConnectionPoints 枚举指向 IConnectionPoint 的指针,因此调用方必须使用 IConnectionPoint::GetConnectionInterface 来确定连接点支持的传出接口的接口标识符。

给调用方的说明

当不再需要枚举器时,调用方负责调用 Release

实施者说明

明确禁止返回E_NOTIMPL,因为除了类型信息外,调用方无法通过其他方式找到传出接口的 IID。 由于可连接对象通常具有一组固定的已知传出接口,因此,在编译时已知的 IID 固定长度数组之上实现枚举器非常简单。

要求

要求
最低受支持的客户端 Windows 2000 专业版 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows 2000 Server [桌面应用 |UWP 应用]
目标平台 Windows
标头 ocidl.h

另请参阅

IConnectionPointContainer

IEnumConnectionPoints