DBSC_Event 结构

DBSC_Event 结构包含有关已请求同步的信息。该结构如下定义：

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

hdl 字段标识结构包含相应信息的同步请求。该值与 Sync 方法返回的句柄相匹配。

类型字段标识所报告的事件的类型。

其余字段包含附加数据，数据的性质取决于类型字段的值。下表列出了可能的类型值以及与每个值相关的其余字段的意义：

DBSC_EVENTTYPE_ERROR_MSG 同步生成了一个错误，并且 str1 指向该错误的文本。
DBSC_EVENTTYPE_WARNING_MSG 同步生成了一个警告，并且 str1 指向该警告的文本。
DBSC_EVENTTYPE_INFO_MSG 同步生成了一个信息性消息，并且 str1 指向该消息的文本。
DBSC_EVENTTYPE_PROGRESS_INDEX 为更新进度条提供信息。val1 包含新的进度值。可通过将 val1 除以 1000 来计算已完成的百分比。
DBSC_EVENTTYPE_PROGRESS_TEXT 已更新与进度条相关的文本，并且 str1 指向新值。
DBSC_EVENTTYPE_TITLE 同步窗口/控件的标题已更改，并且 str1 指向新标题。
DBSC_EVENTTYPE_SYNC_START 同步已开始。没有与此事件相关的更多信息。
DBSC_EVENTTYPE_SYNC_DONE 同步已完成，并且 val1 包含此同步的退出代码。0 值表示操作成功。非零值都表示同步失败。