UltraLite User's Guide
The Embedded SQL Interface
Library function reference
ul_bool ULPalmExit( SQLCA * sqlca, ul_synch_info * synch_info );
Saves application state for UltraLite applications on the Palm Computing Platform, and writes out an upload stream for HotSync synchronization. This function is required by all UltraLite Palm applications.
Call this function just before your application is closed, to save the state of the application.
This function saves the application state when the application is deactivated. For applications using HotSync or Scout Sync synchronization, it carries out the additional task of writing an upload stream. When the user uses HotSync or Scout Sync to synchronize data between their Palm device and a PC, the upload stream is read by the MobiLink HotSync conduit or the MobiLink Scout conduit respectively.
The MobiLink HotSync conduit synchronizes with the MobiLink synchronization server through a TCP/IP or HTTP stream using stream parameters. Specify the stream and stream parameters in synch_info.stream_parms. Alternatively, you may specify the stream and stream parameters via the ClientParms registry entry. If the ClientParms registry entry does not exist, a default setting of {stream=tcpip;host=localhost} is used.
sqlca A pointer to the SQLCA.
synch_info A synchronization structure.
If you are using TCP/IP or HTTP synchronization, supply UL_NULL instead of the ul_synch_info structure. When using these streams, the synchronization information is supplied instead in the call to ULSynchronize.
If you use HotSync or Scout Sync synchronization, supply the synchronization structure. The value of the stream parameter is ignored, and may be UL_NULL.
For information on the members of the synch_info structure, see Synchronization stream parameters.
The function returns a Boolean value.
true Success.
false Failure.