Метод IConnectionPointContainer::FindConnectionPoint (ocidl.h)

Статья
08/25/2023

Возвращает указатель на интерфейс IConnectionPoint точки подключения для указанного IID, если этот IID описывает поддерживаемый исходящий интерфейс.

Синтаксис

HRESULT FindConnectionPoint(
  [in]  REFIID           riid,
  [out] IConnectionPoint **ppCP
);

Параметры

[in] riid

Идентификатор интерфейса исходящего интерфейса, объект точки подключения которого запрашивается.

[out] ppCP

Адрес переменной указателя интерфейса IConnectionPoint , которая получает указатель на точку подключения, поддерживающую интерфейс riid . При возникновении ошибки реализация задает значение 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
Header	ocidl.h

См. также раздел

IConnectionPoint

IConnectionPointContainer

Поделиться через