UltraLite Embedded SQL User's Guide
  Adding Non Data Access Features to UltraLite Applications
    Adding synchronization to your application

Monitoring and canceling synchronization

This section describes how to monitor and cancel synchronization from UltraLite applications.

• An API for monitoring synchronization progress and for canceling synchronization.

• A progress indicator component that implements the interface, which you can add to your application.

Monitoring synchronization 

• Specify the name of your callback function in the observer member of the synchronization structure (ul_synch_info).

• Call the synchronization function or method to start synchronization.

• UltraLite calls your callback function called whenever the synchronization state changes. The following section describes the synchronization state.

The following code shows how this sequence of tasks can be implemented in an embedded SQL application:

ULInitSynchInfo( &info );
info.user_name = m_EmpIDStr;
...
//The info parameter of ULSynchronization() contains
// a pointer to the observer function
info.observer = ObserverFunc;
ULSynchronize( &sqlca, &info );

Handling synchronization status information