Metodo ISyncMgrSyncItemInfo::IsEnabled (syncmgr.h)

Genera un valore che indica se l'elemento è abilitato.

Sintassi

HRESULT IsEnabled();

Valore restituito

Tipo: HRESULT

Restituisce S_OK se l'elemento è abilitato; in caso contrario, S_FALSE.

Se l'elemento desidera che Sync Center mantenga lo stato corrente, può restituire E_NOTIMPL. Se viene restituito un altro valore, Il Centro sincronizzazione imposta lo stato abilitato dell'elemento sull'ultimo valore noto e abilita o disabilita le attività associate in base alle esigenze.

Se i flag SYNCMGR_ICM_QUERY_BEFORE_ENABLE o SYNCMGR_ICM_QUERY_BEFORE_DISABLE vengono impostati nella maschera restituita da GetCapabilities, il gestore deve gestire il proprio stato abilitato e pertanto deve restituire S_OK o S_FALSE. Qualsiasi altro valore restituito verrà considerato un errore.

Commenti

Se un elemento è disabilitato, non viene sincronizzato da Sync Center. Inoltre, molte delle possibili azioni disponibili per un elemento, ad esempio La sincronizzazione, vengono rimosse o disabilitate nell'interfaccia utente.

Un elemento può implementare uno stato Disconnesso restituendo S_FALSE da IsEnabled e impostando il flag SYNCMR_IPM_PREVENT_ENABLE nell'implementazione getPolicies . L'elemento viene visualizzato come disabilitato e impedisce all'utente di abilitarlo manualmente.

Il valore abilitato è 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 CMyDeviceSyncItem::IsEnabled()
{
    // Return a previously-calculated value.
    return (_fIsEnabled ? S_OK : S_FALSE);
}

Requisiti