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的标准返回值,以及以下值。

返回代码 说明
S_OK
该方法已成功完成。
E_POINTER
ppCP 中的地址无效。 例如,它可能为 NULL
CONNECT_E_NOCONNECTION
此可连接对象不支持 riid 指定的传出接口。

注解

此方法是对象的传出接口的 QueryInterface 等效项,其中传出接口是使用 riid 指定的,其中返回的接口指针始终是连接点的接口指针。

给调用方的说明

如果调用成功,则调用方负责在不再需要连接点时通过调用 Release 来释放连接点。

实施者说明

E_NOTIMPL不允许作为此方法的返回值。 IConnectionPointContainer 的任何实现都必须为可连接对象的传出接口实现此方法。

要求

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

另请参阅

IConnectionPoint

IConnectionPointContainer