Contents Index ULPalmExit function ULResetLastDownloadTime function

UltraLite Embedded SQL User's Guide
  Embedded SQL Library Functions

ULPalmLaunch function


Prototype 

UL_PALM_LAUNCH_RET ULPalmLaunch(
SQLCA * sqlca,
ul_synch_info * synch_info );

typedef enum {
LAUNCH_SUCCESS_FIRST,
LAUNCH_SUCCESS,
LAUNCH_FAIL
} UL_PALM_LAUNCH_RET;

Parameters 

sqlca    A pointer to the SQLCA.

synch_info    A synchronization structure. For information on the members of this structure, see Synchronization parameters.

If you are using TCP/IP or HTTP synchronization, supply UL_NULL as synch_info.

Description 

This function restores application state for UltraLite applications on the Palm Computing Platform. This function is required by all UltraLite Palm applications.

Your application must call ULEnablePalmDB or ULEnableFileDB before calling ULPalmLaunch.

All UltraLite Palm applications need to use this function to handle the launch code in your application's PilotMain.

This function restores the application state when the application is activated. For applications using HotSync or Scout Sync synchronization, it carries out the additional task of processing the download stream prepared by the MobiLink HotSync conduit or MobiLink Scout conduit.

If you are using TCP/IP or HTTP synchronization, supply a null value for the stream parameter in the ul_synch_info synchronization structure. This information is supplied instead in the call to ULSynchronize.

Returns 

A member of the UL_PALM_LAUNCH_RET enumeration. The return values have the following meanings:

Examples 

A typical embedded SQL example is

ULEnablePalmRecordDB( &sqlca );
switch( ULPalmLaunch( &sqlca, &synch_info ) ){
case LAUNCH_SUCCESS_FIRST:
   if( !db_init( &sqlca ) ){
      // db_init failed: add error handling here
      break;
   }
   // fall through
case LAUNCH_SUCCESS:
   // do work here
   break;
case LAUNCH_FAIL:
   // error
   break;
}
See also 

Launching an UltraLite Palm application

ULEnableFileDB function

ULEnablePalmRecordDB function


Contents Index ULPalmExit function ULResetLastDownloadTime function