Metodo ISyncMgrHandler::Activate (syncmgr.h)

Articolo
08/26/2023

Richiede che il gestore sia attivato o disattivato. È possibile sincronizzare un gestore attivo; un gestore inattivo non può.

Sintassi

HRESULT Activate(
  [in] BOOL fActivate
);

Parametri

[in] fActivate

Tipo: BOOL

TRUE da attivare; FALSE da disattivare.

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 attivo viene visualizzato nella cartella Sync Center e può essere sincronizzato. Un gestore inattivo viene visualizzato nella cartella Sync Setup e deve essere attivato (che lo sposta nella cartella Sync Center) prima di poter essere sincronizzato.

Lo stato di attivazione non deve essere confuso con lo stato abilitato. Un gestore attivo può essere disabilitato. Ciò significa che è ancora visualizzato nella cartella Sync Center, ma che non può essere sincronizzato.

Sync Center chiama questo metodo nelle due istanze seguenti.

Quando l'utente seleziona il gestore nella cartella Configura sincronizzazione e avvia l'attività Di installazione . Se il gestore supporta l'oggetto SYNCMGR_OBJECTID_QueryBeforeActivate , questo metodo viene chiamato solo se l'operazione dell'interfaccia utente, costituita da una finestra di dialogo che chiede all'utente di confermare se si vuole attivare il gestore, è stata completata.
Quando l'utente seleziona il gestore nella cartella Sync Center e avvia l'attività Elimina , ma solo se il gestore non ha impostato il flag di SYNCMGR_HPM_PREVENT_DEACTIVATE . Se il gestore supporta l'oggetto SYNCMGR_OBJECTID_QueryBeforeDeactivate , questo metodo viene chiamato solo se l'operazione dell'interfaccia utente ha avuto esito positivo.

Se il flag SYNCMGR_HPM_PREVENT_ACTIVATE è impostato nel valore recuperato da ISyncMgrHandler::GetCapabilities, una chiamata a questo metodo che richiede l'attivazione del gestore avrà esito negativo.

Lo stato di attivazione di un singolo gestore può essere trovato chiamando IsActive.

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::Activate(__in BOOL fActivate)
{
    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

ISyncMgrUIOperation::Run

Condividi tramite