Metodo ISyncMgrHandlerInfo::IsActive (syncmgr.h)

Ottiene un valore che indica se il gestore può essere sincronizzato.

Sintassi

HRESULT IsActive();

Valore restituito

Tipo: HRESULT

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

Se il gestore vuole che Sync Center mantenga lo stato corrente, può restituire E_NOTIMPL. Se viene restituito un altro valore, Sync Center imposta lo stato del gestore sull'ultimo valore noto. Se l'ultimo valore noto del gestore in tale situazione era inattivo, Sync Center disabilita l'attività di installazione . Se l'ultimo valore noto del gestore era attivo, l'attività Elimina non è disabilitata.

Se il flag SYNCMGR_HCM_QUERY_BEFORE_ACTIVATE o SYNCMGR_HCM_QUERY_BEFORE_DEACTIVE è impostato nella maschera restituita da GetCapabilities, il gestore deve gestire il proprio stato di attivazione e pertanto deve restituire S_OK o S_FALSE. Qualsiasi altro valore restituito verrà considerato un errore.

Commenti

Se un gestore non è attivo, viene visualizzato nella cartella Sync Setup .If a handler is not active, it appears in the Sync Setup folder. I gestori in tale cartella non possono essere sincronizzati. Per spostare un gestore nella cartella Centro sincronizzazione, l'utente seleziona l'attività Di installazione nel menu di scelta rapida del gestore o dal modulo di comando.

Se un gestore è attivo, viene visualizzato nella cartella principale del Centro sincronizzazione. Un gestore attivo può essere sincronizzato dall'utente o tramite l'interfaccia ISyncMgrControl . Per spostare un gestore nella cartella Di installazione sincronizzazione, l'utente seleziona l'attività Elimina nel menu di scelta rapida del gestore o nel modulo di comando.

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

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

Requisiti

Vedi anche

Attiva

ISyncMgrHandlerInfo