Método ISyncMgrHandlerInfo::IsConnected (syncmgr.h)

Obtém um valor que indica se o manipulador, normalmente algum tipo de dispositivo externo, está conectado.

Sintaxe

HRESULT IsConnected();

Valor de retorno

Tipo: HRESULT

Retorna S_OK se o manipulador estiver conectado; caso contrário, S_FALSE. Um erro retornado por esse método será interpretado como S_OK.

Observações

Se um manipulador estiver desconectado, nem ele nem qualquer um de seus itens serão sincronizados pelo Sync Center. Além disso, muitas das ações possíveis disponíveis para um manipulador, como Sincronização, são removidas ou desabilitadas na interface do usuário da pasta do Sync Center.

Esse valor está disponível na interface do usuário da pasta como a propriedade System.Sync.Connected (PKEY_Sync_Connected).

A Central de Sincronização chama esse método sempre que o método UpdateHandler é chamado.

Exemplos

O exemplo a seguir mostra uma implementação desse método que chama uma função de classe privada para recuperar o estado conectado.

STDMETHODIMP CMyDeviceHandler::IsConnected()
{
    return (_IsConnected() ? S_OK : S_FALSE);
}

Requirements