Función ConnectToConnectionPoint (shlwapi.h)

[Esta función está disponible a través de Windows XP y Windows Server 2003. Puede modificarse o no estar disponible en versiones posteriores de Windows.]

Establece o finaliza una conexión entre el receptor de un cliente y un contenedor de punto de conexión.

Syntax

LWSTDAPI ConnectToConnectionPoint(
  [in, optional]  IUnknown         *punk,
  [in]            REFIID           riidEvent,
                  BOOL             fConnect,
  [in]            IUnknown         *punkTarget,
  [out]           DWORD            *pdwCookie,
  [out, optional] IConnectionPoint **ppcpOut
);

Parámetros

[in, optional] punk

Tipo: IUnknown*

Puntero a la interfaz IUnknown del objeto que se va a conectar al contenedor del punto de conexión. Si establece fConnect en FALSE para indicar que está desconectando el objeto, este parámetro se omite y se puede establecer en NULL.

[in] riidEvent

Tipo: REFIID

IID de la interfaz en el contenedor del punto de conexión cuyo objeto de punto de conexión se solicita.

fConnect

Tipo: BOOL

TRUE si se establece una conexión; FALSE si se interrumpe una conexión.

[in] punkTarget

Tipo: IUnknown*

Puntero a la interfaz IUnknown del contenedor del punto de conexión.

[out] pdwCookie

Tipo: DWORD*

Un token de conexión. Si establece fConnect en TRUE para realizar una nueva conexión, este parámetro recibe un token que identifica de forma única la conexión. Si establece fConnect en FALSE para interrumpir una conexión, este parámetro debe apuntar al token que recibió cuando llamó a ConnectToConnectionPoint para establecer la conexión.

[out, optional] ppcpOut

Tipo: IConnectionPoint**

Puntero a la interfaz IConnectionPoint del contenedor del punto de conexión, si la operación se realizó correctamente. La aplicación que realiza la llamada debe liberar este puntero cuando ya no sea necesario. Si la solicitud no se realiza correctamente, el puntero recibe NULL. Este parámetro es opcional y se puede NULL.

Valor devuelto

Tipo: HRESULT

Si esta función se ejecuta correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT .

Requisitos