Metodo ISyncMgrHandlerInfo::IsEnabled (syncmgr.h)

Ottiene un valore che indica se il gestore è abilitato.

Sintassi

HRESULT IsEnabled();

Valore restituito

Tipo: HRESULT

Restituisce S_OK se il gestore è abilitato; in caso contrario, S_FALSE.

Se il gestore vuole mantenere lo stato corrente, il centro sincronizzazione può restituire E_NOTIMPL. Se viene restituito un altro valore, Il Centro sincronizzazione imposta lo stato abilitato del gestore sull'ultimo valore noto e abilita o disabilita le attività associate in base alle esigenze.

Se il flag SYNCMGR_HCM_QUERY_BEFORE_ENABLE o SYNCMGR_HCM_QUERY_BEFORE_DISABLE viene impostato nella maschera restituita da GetCapabilities, il gestore deve gestire lo stato abilitato e quindi deve restituire S_OK o S_FALSE. Qualsiasi altro valore restituito verrà considerato un errore.

Commenti

Se un gestore è disabilitato, 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.Enabled (PKEY_Sync_Enabled).

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 abilitato.

STDMETHODIMP CMyDeviceHandler::IsEnabled()
{
    // Return a previously-calculated value.
    return (_fIsEnabled ? S_OK : S_FALSE);
}

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	syncmgr.h

Vedi anche

Attiva

ISyncMgrHandlerInfo