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 puntos de conexión.

Sintaxis

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 de puntos 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 de puntos 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 está interrumpiendo 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 establecer 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ó al llamar 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 puede ser NULL.

Valor devuelto

Tipo: HRESULT

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

Requisitos