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

Статья
03/05/2024

Создает объект перечислителя для итерации всех точек подключения, поддерживаемых в подключаемом объекте, по одной точке соединения на каждый исходящий 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 исходящих интерфейсов. Так как подключаемый объект обычно имеет фиксированный набор известных исходящих интерфейсов, легко реализовать перечислитель поверх массива ИДЕНТИФИКАТОРов фиксированной длины, известных во время компиляции.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Профессиональная [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows 2000 Server [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	ocidl.h

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

IConnectionPointContainer

IEnumConnectionPoints

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