Metodo ISyncMgrSynchronize::Synchronize (mobsync.h)

Articolo
03/15/2023

Chiamato dalla gestione sincronizzazione una volta per ogni gruppo selezionato dopo che l'utente ha scelto di sincronizzare le applicazioni registrate.

Sintassi

HRESULT Synchronize(
  [in] HWND hWndParent
);

Parametri

[in] hWndParent

Tipo: HWND

Un handle per l'HWND padre che l'applicazione registrata deve usare per tutti gli elementi dell'interfaccia utente visualizzati. Questo valore può essere NULL.

Valore restituito

Tipo: HRESULT

Questo metodo supporta i valori restituiti standard, E_INVALIDARG, E_UNEXPECTED e E_OUTOFMEMORY, nonché i seguenti:

Codice restituito	Descrizione
S_OK	Sincronizzazione riuscita.
E_FAIL	Sincronizzazione non riuscita.

Commenti

Se l'utente non seleziona alcuna scelta di elementi per l'applicazione registrata, il metodo ISyncMgrhronize::Synchronize non viene chiamato e l'interfaccia viene rilasciata. Se questo metodo viene chiamato, l'applicazione deve sincronizzare gli elementi specificati nel metodo ISyncMgrSynchronize::P repareForSync .

Il gestore dell'applicazione registrata deve restituire il prima possibile dal metodo ISyncMgrSynchronize::Synchronize e quindi chiamare il metodo SynchronizeCompleted . È accettabile che il gestore chiami la chiamata SynchronizeCompleted prima di restituire dal metodo ISyncMgrSynchronize::Synchronize .

L'applicazione deve fornire commenti e suggerimenti sullo stato di avanzamento e verificare se la sincronizzazione deve essere annullata usando il puntatore all'interfaccia pSyncCallBack configurato nel metodo ISyncMgrSynchronize::SetProgressCallback .

Le applicazioni devono fornire informazioni sullo stato di avanzamento anche se il flag di SYNCMGRFLAG_MAYBOTHERUSER non è stato specificato in ISyncMgrSynchronize::Initialize.

Le applicazioni devono provare a non visualizzare gli elementi dell'interfaccia utente dal metodo ISyncMgrSynchronize::Synchronize . Tutti gli elementi dell'interfaccia utente devono essere visualizzati nei metodi ISyncMgrSynchronize::P repareForSync e ISyncMgrSynchronize::ShowError in modo che l'utente finale esperienze un'interfaccia utente coerente, limitata all'accesso e alla specifica delle condivisioni da sincronizzare. Successivamente, la sincronizzazione può essere eseguita senza alcun intervento dell'utente. Al termine della sincronizzazione, è possibile visualizzare conflitti o altri messaggi di errore.

I metodi ISyncMgrSynchronizeCallback possono essere chiamati in qualsiasi thread dell'applicazione.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mobsync.h
DLL	Mobsync.dll