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

  • Artículo

Devuelve un puntero a la interfaz IConnectionPoint de un punto de conexión para un IID especificado, si ese IID describe una interfaz saliente compatible.

Sintaxis

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

Parámetros

[in] riid

Identificador de interfaz de la interfaz saliente cuyo objeto de punto de conexión se solicita.

[out] ppCP

Dirección de una variable de puntero de interfaz IConnectionPoint que recibe el puntero al punto de conexión que admite la interfaz riid . Si se produce un error, la implementación establece el valor en NULL.

Valor devuelto

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

Código devuelto Descripción
S_OK
 El método se completó correctamente.
E_POINTER
 La dirección de ppCP no es válida. Por ejemplo, puede ser NULL.
CONNECT_E_NOCONNECTION
 Este objeto conectable no admite la interfaz saliente especificada por riid.

Comentarios

Este método es el equivalente de QueryInterface para las interfaces salientes de un objeto, donde se especifica la interfaz saliente con riid y donde el puntero de interfaz devuelto siempre es el de un punto de conexión.

Notas a los autores de llamadas

Si la llamada es correcta, el autor de la llamada es responsable de liberar el punto de conexión llamando a Release cuando el punto de conexión ya no sea necesario.

Notas para los implementadores

E_NOTIMPL no se permite como valor devuelto para este método. Cualquier implementación de IConnectionPointContainer debe implementar este método para las interfaces salientes del objeto conectable.

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

IConnectionPoint

IConnectionPointContainer