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

SQL Anywhere 11.0.0 » MobiLink - Client Administration » Introduction to SQL Anywhere Clients for MobiLink » Dbmlsync API » Dbmlsync API for C++


The DBSC_Event Structure

The DBSC_Event structure contains information about a synchronization that has been requested. The structure is defined as follows:

typedef struct {
    DBSC_SyncHdl	hdl;		
    DBSC_EventType	type;
    const char 		*str1;
    const char		*str2;
    long int		val1;
    long int		val2;
    void			*data;
} DBSC_Event;

The hdl field identifies the synchronization request for which the structure contains information. This value matches the handle returned by the Sync method.

The type field identifies the type of event being reported.

The remaining fields contain additional data, the nature of which depends on the value of the type field. Following is a list of the possible type values and the meaning of the remaining fields associated with each:

Value Description

An error was generated by the synchronization and str1 points to the text of the error.


A warning was generated by the synchronization and str1 points to the text of the warning.


An information message was generated by the synchronization and str1 points to the text of the message.


Provides information for updating a progress bar. val1 contains the new progress value. The percent done can be calculated by dividing val1 by 1000.


The text associated with the progress bar has been updated and the new value is pointed to by str1.


The title for the synchronization window/control has changed and the new title is pointed to by str1.


The synchronization has begun. There is no additional information associated with this event.


The synchronization is complete and val1 contains the exit code from the synchronization. A 0 value indicates success. A non-zero value indicates that the synchronization failed.