Collection Contents Previous Next PDF

UltraLite C/C++ User's Guide

UltraLite Static C++ API Reference

ULData class

PalmExit method [deprecated]


Prototype 

bool PalmExit( SQLCA *ca )

bool PalmExit( ul_synch_info * synch_info )

Description 
Deprecated feature 
This function is no longer required. Use ULData::Close instead.

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. You can tune the synchronization by specifying a set of stream parameters or network protocol options 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.

Parameters 

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.

Returns 

true (1) if successful.

false (0) if unsuccessful


Collection Contents Previous Next PDF