Função CoIsHandlerConnected (combaseapi.h)

Determina se um objeto remoto está conectado ao objeto em processo correspondente.

Sintaxe

BOOL CoIsHandlerConnected(
  [in] LPUNKNOWN pUnk
);

Parâmetros

[in] pUnk

Um ponteiro para a interface IUnknown de controle no objeto remoto.

Retornar valor

Se o objeto não for remoto ou se for remoto e ainda estiver conectado, o valor retornado será TRUE; caso contrário, será FALSE.

Comentários

A função CoIsHandlerConnected determina o status de um objeto remoto. Você pode usá-lo para determinar quando liberar um objeto remoto. Especifique o objeto remoto fornecendo à função um ponteiro para sua interface IUnknown de controle (o parâmetro pUnk ). Um valor true retornado da função indica que o objeto especificado não é remoto ou que ele é remoto e ainda está conectado ao manipulador remoto. Um valor false retornado da função indica que o objeto é remoto, mas não está mais conectado ao manipulador remoto; nesse caso, o chamador deve responder liberando o objeto .

Requisitos