Método IConnectionPointContainer::EnumConnectionPoints (ocidl.h)

Crea un objeto de enumerador para recorrer en iteración todos los puntos de conexión admitidos en el objeto conectable, un punto de conexión por IID saliente.

Sintaxis

HRESULT EnumConnectionPoints(
  [out] IEnumConnectionPoints **ppEnum
);

Parámetros

[out] ppEnum

Puntero a una variable de puntero de interfaz IEnumConnectionPoints que recibe el puntero al enumerador recién creado.

Valor devuelto

Este método puede devolver los valores devueltos estándar E_OUTOFMEMORY y E_UNEXPECTED, así como los valores siguientes.

Código devuelto	Descripción
S_OK	El objeto enumerador se creó correctamente.
E_POINTER	La dirección de ppEnum no es válida. Por ejemplo, puede ser NULL.

Comentarios

Dado que IEnumConnectionPoints enumera punteros a IConnectionPoint, el autor de la llamada debe usar IConnectionPoint::GetConnectionInterface para determinar el identificador de interfaz de la interfaz saliente que admite el punto de conexión.

Notas a los autores de llamadas

El autor de la llamada es responsable de llamar a Release cuando el enumerador ya no es necesario.

Notas para los implementadores

Devolver E_NOTIMPL no se permite específicamente porque, con la excepción de la información de tipo, no habría ningún otro medio a través del cual un autor de la llamada pudiera encontrar los IID de las interfaces salientes. Dado que un objeto conectable normalmente tiene un conjunto fijo de interfaces salientes conocidas, es sencillo implementar el enumerador sobre una matriz de longitud fija de IID conocidas en tiempo de compilación.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	ocidl.h

Consulte también

IConnectionPointContainer

IEnumConnectionPoints