Synchronization parameters

UltraLite User's Guide
UltraLite Reference

Synchronization parameters

The synchronization parameters are grouped into a structure (C/C++) or object (Java) that is provided as an argument in the call to synchronize. The C/C++ structure has the following members, and the Java UlSynchOptions object has equivalent access methods.

String parameters are null-terminated strings in C/C++, and String objects in Java.

Use UL_TEXT around constant strings in C/C++ applications

The UL_TEXT macro allows constant strings to be compiled as single-byte strings or wide-character strings. In embedded SQL and C++ API applications, use this macro to enclose all constant strings supplied as members of the ul_synch_info structure so that the compiler handles these parameters correctly.

For C/C++ users, the ul_synch_info structure that holds the synchronization parameters is defined in ulglobal.h as follows:

struct ul_synch_info {   
    ul_char *             user_name; 
    ul_char *             password; 
    ul_char *             new_password; 
    ul_char *             version; 
    p_ul_stream_defn      stream; 
    ul_stream_error          stream_error; 
    ul_char *             stream_parms; 
    p_ul_stream_defn      security; 
    ul_char *             security_parms; 
    ul_synch_observer_fn  observer; 
    ul_void *             user_data; 
    ul_bool               upload_only; 
    ul_bool               download_only; 
    ul_bool               upload_ok;
    ul_bool               ignored_rows;
    ul_auth_status        auth_status;
    ul_bool               send_download_ack;
    ul_publication_mask   publication;
    ul_bool               send_column_names;
    ul_s_long             auth_value;
    ul_bool               checkpoint_store; 
    ul_bool               ping;
    p_ul_synch_info          init_verify; 
};

The init_verify field is reserved for internal use.