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 |