Compartir a través de


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