Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

SQL Anywhere 10.0.1 » UltraLite - C and C++ Programming » Embedded SQL API Reference

ULGetLastDownloadTime function Next Page

ULGetSynchResult function

Stores the results of the most recent synchronization, so that appropriate action can be taken in the application:


ul_bool ULGetSynchResult( ul_synch_result * synch-result );


synch-result    A structure to hold the synchronization result. It is defined in ulglobal.h as follows:

typedef struct {
an_sql_code sql_code;
ul_stream_error stream_error;
ul_bool upload_ok;
ul_bool ignored_rows;
ul_auth_status auth_status;
ul_s_long auth_value;
SQLDATETIME timestamp;
ul_synch_status status;
} ul_synch_result, * p_ul_synch_result;

The individual parameters include:


The application must allocate a ul_synch_result object before passing it to ULGetSynchResult. The function fills the ul_synch_result with the result of the last synchronization. These results are stored persistently in the database.

The function is of particular use when synchronizing applications on the Palm OS using HotSync, as the synchronization takes place outside the application itself. The SQLCODE value set in the connection reflect the result of the connecting operation itself. The synchronization status and results are written to the HotSync log only. To obtain extended synchronization result information, call ULGetSynchResult when connected to the database.


The following code checks for success of the previous synchronization.

ul_synch_result synch_result;
memset( &synch_result, 0, sizeof( ul_synch_result ) );
db_init( &sqlca );
if( !ULGetSynchResult( &sqlca, &synch_result ) ) {
    prMsg( "ULGetSynchResult failed" );