UltraLite User's Guide
Developing Applications for the Palm Computing Platform
This section describes what you need to include in your UltraLite application code to synchronize using HotSync. From the UltraLite application side, the procedure is very similar for these two synchronization streams.
For an overview of HotSync, see Understanding HotSync synchronization.
For information about configuring HotSync, see Configuring HotSync synchronization.
If you use HotSync, then you synchronize by calling ULPalmLaunch (embedded SQL) or ULData.PalmLaunch ( C++ API ) when your application is launched, and ULPalmExit (embedded SQL) or ULData.PalmExit (C++ API ) when your application is closed. You must supply a ul_synch_info structure holding the synchronization parameters to ULPalmExit or ULData.PalmExit. The stream parameter for the ul_synch_info structure is ignored, and can be UL_NULL.
Do not use ULSynchronize or ULConnection.Synchronize for HotSync synchronization.
For more information, see Launching and closing UltraLite applications, and Synchronization parameters.
If there are uncommitted transactions when you close your Palm application, and if you synchronize, the conduit reports that synchronization fails because of uncommitted changes in the database.
The synchronization stream parameters in the ul_synch_info structure control communication with the MobiLink synchronization server. For HotSync synchronization, the UltraLite application does not communicate directly with a MobiLink synchronization server; it is the HotSync conduit instead.
You can supply synchronization stream parameters to govern the behavior of the MobiLink conduit in one of the following ways:
Supply the required information in the stream_parms member of ul_synch_info passed to ULPalmExit or ULData.PalmExit.
For a list of available values, see Synchronization stream parameters.
Supply a null value for the stream_parms member. The MobiLink conduit then searches in the ClientParms registry entry on the machine where it is running for information on how to connect to the MobiLink synchronization server.
The stream and stream parameters in the registry entry are specified in the same format as in the ul_synch_info structure stream_parms field.
For more information, see HotSync configuration overview.
Adding HotSync synchronization to your application