Share via

Metodo ISyncMgrHandler::Enable (syncmgr.h)

  • Articolo

Richiede che un gestore attivo sia abilitato o disabilitato. Un gestore abilitato può essere sincronizzato e un gestore disabilitato non può.

Sintassi

HRESULT Enable(
  [in] BOOL fEnable
);

Parametri

[in] fEnable

Tipo: BOOL

TRUE per abilitare; FALSE da disabilitare.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Un gestore deve impostare i flag SYNCMGR_HCM_CAN_ENABLE e SYNCMGR_HCM_CAN_DISABLE per le voci Abilita e Disabilita da visualizzare nel menu di scelta rapida del gestore quando il gestore viene visualizzato nella cartella Centro sincronizzazione. La scelta di abilitare un gestore significa che può essere sincronizzata; la scelta di disabilitare un gestore significa che non può.

Sync Center chiama questo metodo nelle due istanze seguenti.

  • Quando l'utente seleziona il gestore nella cartella Centro sincronizzazione e avvia l'attività Abilita . Se il gestore supporta l'oggetto SYNCMGR_OBJECTID_QueryBeforeEnable , questo metodo viene chiamato solo se l'operazione dell'interfaccia utente ha avuto esito positivo.
  • Quando l'utente seleziona il gestore nella cartella Centro sincronizzazione e avvia l'attività Disabilita . Se il gestore supporta l'oggetto SYNCMGR_OBJECTID_QueryBeforeDisable , questo metodo viene chiamato solo se l'operazione dell'interfaccia utente ha avuto esito positivo.
Se il gestore non deve eseguire alcuna azione quando viene attivata, può restituire S_OK o E_NOTIMPL, come illustrato nell'esempio seguente.

Esempio

Nell'esempio seguente viene illustrata una semplice implementazione di questo metodo.

STDMETHODIMP CMyDeviceHandler::Enable(__in BOOL fEnable)
{
    return E_NOTIMPL;
}

Requisiti

   
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

ISyncMgrHandler

ISyncMgrHandler::GetObject

IsEnabled