Método IConnectionPoint::Advise (ocidl.h)

  • Artículo

Establece una conexión entre un objeto de punto de conexión y el receptor del cliente.

Sintaxis

HRESULT Advise(
  [in]  IUnknown *pUnkSink,
  [out] DWORD    *pdwCookie
);

Parámetros

[in] pUnkSink

Puntero a la interfaz IUnknown en el receptor de aviso del cliente. El receptor del cliente recibe llamadas salientes desde el punto de conexión.

[out] pdwCookie

Puntero a un token devuelto que identifica de forma única esta conexión. El autor de la llamada usa este token más adelante para eliminar la conexión pasándola al método IConnectionPoint::Unadvise . Si la conexión no se estableció correctamente, este valor es cero.

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
 La conexión se ha establecido y *pdwCookie tiene el token de conexión.
E_POINTER
 El valor de pUnkSink o pdwCookie no es válido. Por ejemplo, cualquiera de los punteros puede ser NULL.
CONNECT_E_ADVISELIMIT
 El punto de conexión ha alcanzado su límite de conexión y no puede aceptar más.
CONNECT_E_CANNOTCONNECT
 El receptor no admite la interfaz requerida por este punto de conexión.

Comentarios

Aviso establece una conexión entre el punto de conexión y el receptor del autor de la llamada identificado con pUnkSink.

El punto de conexión debe llamar a QueryInterface para obtener el puntero de interfaz saliente correcto para llamar cuando se produzcan eventos, con el IID para la interfaz saliente administrada por el punto de conexión. Cuando el IID se pasa al método IConnectionPointContainer::FindConnectionPoint , se devuelve un puntero de interfaz a este mismo punto de conexión.

Notas para los implementadores

El punto de conexión debe consultar el puntero pUnkSink para la interfaz saliente correcta. Si se produce un error en esta consulta, este método debe devolver CONNECT_E_CANNOTCONNECT.

El valor pdwCookie debe ser único para cada conexión a cualquier instancia determinada de un punto de conexió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

IConnectionPoint