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

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	combaseapi.h (inclua Objbase.h)
Biblioteca	Ole32.lib
DLL	Ole32.dll