Platform SDK: Synchronization Manager

ISyncMgrSynchronizeCallback

The ISyncMgrSynchronizeCallback interface manages the synchronization process.

When to Implement

This interface is implemented by the Synchronization Manager to receive status, error, and progress information and display the user interface during the synchronization process.

When to Use

Applications should call the methods of this interface as often as possible and must call it before starting each new ItemID to check whether the user has canceled an individual item.

Methods in Vtable Order

IUnknown methods Description
QueryInterface Returns pointers to supported interfaces.
AddRef Increments reference count.
Release Decrements reference count.

ISyncMgrSynchronizeCallback methods Description
Progress Updates the progress information and determines if the operation should continue.
ShowPropertiesCompleted Must by called by the handler before or after its ShowProperties method is complete.
PrepareForSyncCompleted Must be called by the handler when its PrepareForSync method is complete.
SynchronizeCompleted Must be called by the application when its Synchronize method is complete.
ShowErrorCompleted Must be called by the handler before or after its PrepareForSync method is complete.
EnableModeless Must be called by the application before and after any dialog boxes are displayed from within the PrepareForSync and Synchronize methods.
LogError Called by the application to log an information, warning, or error message into the Error tab on the SyncMgr status dialog.
DeleteLogError Called by the handler to delete a previously logged ErrorInformation, warning, or error message in the error tab on the SyncMgr status dialog box.
EstablishConnection Called by the handler when it requires the system to establish a network a network connection.

Requirements

  Windows NT/2000: Requires Windows 2000 (or Windows NT 4.0 with Internet Explorer 5 or later).
  Windows 95/98: Requires Windows 95 or later (with Internet Explorer 5 or later).
  Header: Declared in Mobsync.h.

See Also

ISyncMgrSynchronize