Función CoIsHandlerConnected (combaseapi.h)

Determina si un objeto remoto está conectado al objeto en proceso correspondiente.

Sintaxis

BOOL CoIsHandlerConnected(
  [in] LPUNKNOWN pUnk
);

Parámetros

[in] pUnk

Puntero a la interfaz IUnknown de control en el objeto remoto.

Valor devuelto

Si el objeto no es remoto o si está remoto y sigue conectado, el valor devuelto es TRUE; de lo contrario, es FALSE.

Comentarios

La función CoIsHandlerConnected determina el estado de un objeto remoto. Puede usarlo para determinar cuándo liberar un objeto remoto. Para especificar el objeto remoto, se proporciona a la función un puntero a su interfaz IUnknown de control (el parámetro pUnk ). Un valor de TRUE devuelto por la función indica que el objeto especificado no es remoto o que es remoto y sigue conectado a su controlador remoto. Un valor false devuelto por la función indica que el objeto es remoto, pero ya no está conectado a su controlador remoto; en este caso, el autor de la llamada debe responder liberando el objeto .

Requisitos