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

Gera um valor que indica se o item, normalmente algum tipo de dispositivo externo, está conectado.

Sintaxe

HRESULT IsConnected();

Valor de retorno

Tipo: HRESULT

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

Observações

Se um item estiver desconectado, ele não será sincronizado pelo Sync Center. Além disso, muitas das ações possíveis disponíveis para um item, como Sincronização, são removidas ou desabilitadas na interface do usuário.

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 CMyDeviceSyncItem::IsConnected()
{
    return (_IsConnected() ? S_OK : S_FALSE);
}

Requirements