Metodo ISyncMgrHandlerInfo::IsConnected (syncmgr.h)

Ottiene un valore che indica se il gestore, in genere un tipo di dispositivo esterno, è connesso.

Sintassi

HRESULT IsConnected();

Valore restituito

Tipo: HRESULT

Restituisce S_OK se il gestore è connesso; in caso contrario, S_FALSE. Un errore restituito da questo metodo verrà interpretato come S_OK.

Commenti

Se un gestore viene disconnesso, né esso né nessuno dei relativi elementi verrà sincronizzato dal Centro sincronizzazione. Inoltre, molte delle possibili azioni disponibili per un gestore, ad esempio Sync, vengono rimosse o disabilitate nell'interfaccia utente della cartella Sync Center.

Questo valore è disponibile nell'interfaccia utente della cartella come proprietà System.Sync.Connected (PKEY_Sync_Connected).

Sync Center chiama questo metodo ogni volta che viene chiamato il metodo UpdateHandler .

Esempio

Nell'esempio seguente viene illustrata un'implementazione di questo metodo che chiama una funzione di classe privata per recuperare lo stato connesso.

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

Requisiti