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

  • Artigo

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

Sintaxe

HRESULT IsConnected();

Retornar valor

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.

Comentários

Se um item for desconectado, ele não será sincronizado pelo Centro de Sincronização. 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).

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 CMyDeviceSyncItem::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