IConnectionPointContainer::FindConnectionPoint 方法 (ocidl.h)
如果指定 IID 描述支持的传出接口,则返回指向指定 IID 的连接点的 IConnectionPoint 接口的指针。
语法
HRESULT FindConnectionPoint(
[in] REFIID riid,
[out] IConnectionPoint **ppCP
);
参数
[in] riid
正在请求其连接点对象的传出接口的接口标识符。
[out] ppCP
接收指向支持 riid 接口的连接点的指针的 IConnectionPoint 接口指针变量的地址。 如果发生错误,则实现会将值设置为 NULL。
返回值
此方法可以返回E_OUTOFMEMORY和E_UNEXPECTED的标准返回值,以及以下值。
返回代码 | 说明 |
---|---|
|
该方法已成功完成。 |
|
ppCP 中的地址无效。 例如,它可能为 NULL。 |
|
此可连接对象不支持 riid 指定的传出接口。 |
注解
此方法是对象的传出接口的 QueryInterface 等效项,其中传出接口是使用 riid 指定的,其中返回的接口指针始终是连接点的接口指针。
给调用方的说明
如果调用成功,则调用方负责在不再需要连接点时通过调用 Release 来释放连接点。实施者说明
E_NOTIMPL不允许作为此方法的返回值。 IConnectionPointContainer 的任何实现都必须为可连接对象的传出接口实现此方法。要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 专业版 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows 2000 Server [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | ocidl.h |