UltraLite User's Guide
  Developing Applications for the Palm Computing Platform
    Adding HotSync synchronization to Palm applications

Adding HotSync synchronization to your application

To call HotSync synchronization from your application you must add code for the following steps:

1. Prepare a ul_synch_info structure.

2. Call the ULPalmExit or ULData.PalmExit function, supplying the ul_synch_info structure as an argument.

   This function is called when the user switches away from the UltraLite application. You must ensure that all outstanding operations are committed before calling the ULPalmExit or ULData.PalmExit function.

   The ul_synch_info.stream parameter is ignored, and so does not need to be set.

3. Call the ULPalmLaunch or ULData.PalmLaunch function

To add HotSync synchronization code to your application

• In the source code for your UltraLite application call ULPalmExit() or ULData.PalmExit with parameters such as the following:

  ul_synch_info info;
  ULInitSynchInfo( &info );
  info.stream_parms =
    UL_TEXT( "stream=tcpip;host=localhost" );
  info.user_name = UL_TEXT( "50" );
  info.version = UL_TEXT( "custdb" );
  
  if( !ULPalmExit( &sqlca, &info ) ) {
    return( false );
  }

  For more information, see Adding HotSync synchronization to Palm applications.

A MobiLink HotSync conduit is required for HotSync synchronization of UltraLite applications.

For a description of how to set up your MobiLink HotSync conduit, see Configuring HotSync synchronization.