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();

Retornar valor

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.

Comentários

Se um manipulador estiver desconectado, nem ele nem qualquer um de seus itens serão sincronizados pelo Centro de Sincronização. 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 Centro de Sincronização.

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

O Sync Center 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);
}

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	syncmgr.h