IConnectionPointContainer::EnumConnectionPoints 方法 (ocidl.h)
创建枚举器对象以循环访问可连接对象中支持的所有连接点,每个传出 IID 一个连接点。
语法
HRESULT EnumConnectionPoints(
[out] IEnumConnectionPoints **ppEnum
);
参数
[out] ppEnum
指向 IEnumConnectionPoints 接口指针变量的指针,该指针接收指向新创建的枚举器的指针。
返回值
此方法可以返回E_OUTOFMEMORY和E_UNEXPECTED的标准返回值,以及以下值。
返回代码 | 说明 |
---|---|
|
已成功创建枚举器对象。 |
|
ppEnum 中的地址无效。 例如,它可能为 NULL。 |
注解
由于 IEnumConnectionPoints 枚举指向 IConnectionPoint 的指针,因此调用方必须使用 IConnectionPoint::GetConnectionInterface 来确定连接点支持的传出接口的接口标识符。
给调用方的说明
当不再需要枚举器时,调用方负责调用 Release 。实施者说明
明确禁止返回E_NOTIMPL,因为除了类型信息外,调用方无法通过其他方式找到传出接口的 IID。 由于可连接对象通常具有一组固定的已知传出接口,因此,在编译时已知的 IID 固定长度数组之上实现枚举器非常简单。要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 专业版 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows 2000 Server [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | ocidl.h |