UltraLite Static C++ User's Guide
C++ API Reference
ULData class
bool PalmExit( SQLCA *ca )
bool PalmExit( ul_synch_info * synch_info )
Call this method just before your application is closed, to save the state of the application.
For applications using HotSync or Scout Sync synchronization, the method also writes 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 the 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. You do not need to supply this argument unless you are using embedded SQL as well as the C++ API in your application and have used a non-default 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 parameters.
true (1) if successful.
false (0) if unsuccessful