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

SQL Anywhere 11.0.1 (中文) » UltraLite - C 及 C++ 编程 » API 参考 » UltraLite C++ API 参考

 

ul_synch_info_a 结构

用于描述同步数据的结构。

语法
public ul_synch_info_a
属性
名称 类型 说明
additional_parms const char *

一串附加同步参数,编码为分号分隔的 "关键字=值" 对的列表。此字段通常包含不经常使用的同步参数。请参见Additional Parameters 同步参数

auth_parms char **

MobiLink 事件中的验证参数的数组。

auth_status ul_auth_status

MobiLink 用户验证的状态。MobiLink 服务器将此信息提供给向客户端。

auth_value ul_s_long

自定义 MobiLink 用户验证脚本的结果。MobiLink 服务器将此信息提供给客户端以确定验证状态。

download_only ul_bool

在当前同步期间不从 UltraLite 数据库上载任何更改。

ignored_rows ul_bool

忽略的行的状态。如果 MobiLink 服务器在同步期间由于缺少脚本而忽略了任何行,则此只读字段将报告 true。

init_verify ul_synch_info_a *

初始化验证。

keep_partial_download ul_bool

在同步期间当下载由于通信错误而失败时,此参数控制 UltraLite 是否保存部分下载而不回退更改。

new_password char *

用来指定与用户名相关联的新的 MobiLink 口令的字符串。此参数是可选的。

num_auth_parms ul_byte

传送到 MobiLink 事件中的验证参数的验证参数的数目。

observer ul_synch_observer_fn

指向用于监控同步的回调函数或事件处理程序的指针。此参数是可选的。

partial_download_retained ul_bool

在同步期间当下载由于通信错误而失败时,此参数将表示 UltraLite 是否应用这些已下载的更改而不回退这些更改。

password char *

用来指定与用户名相关联的现有 MobiLink 口令的字符串。此参数是可选的。

ping ul_bool

确认 UltraLite 客户端和 MobiLink 服务器之间的通信。当此参数设置为 true 时,不进行同步。

publications const char *

以逗号分隔的发布列表,表示同步中包含什么数据。

resume_partial_download ul_bool

重新开始失败的下载。同步不上载更改;它仅下载那些要在失败的下载中下载的更改。

send_column_names ul_bool

指示应在上载中被发送到 MobiLink 服务器的列名的应用程序。

send_download_ack ul_bool

指示 MobiLink 服务器此客户端是否将提供下载确认。

stream const char *

用于同步的 MobiLink 网络协议。

stream_error ul_stream_error

用于保存通信错误报告信息的结构。

stream_parms char *

用于配置所选网络协议的选项。

upload_ok ul_bool

上载到 MobiLink 服务器的数据的状态。如果上载成功,此字段将报告 true。

upload_only ul_bool

在当前同步期间不从统一数据库下载任何更改。这样可以节省通信时间,在通信链接很慢时尤其如此。

user_data ul_void *

使应用程序特定的信息可用于同步观察器。此参数是可选的。

user_name char *

MobiLink 服务器用于标识唯一 MobiLink 用户的字符串。

version char *

版本字符串使 UltraLite 应用程序可以从一组同步脚本中进行选择。

注释

同步参数控制 UltraLite 数据库和 MobiLink 服务器之间的同步行为。Stream Type 同步参数、User Name 同步参数和 Version 同步参数是必需的。如果未设置这些参数,同步函数将返回错误(SQLE_SYNC_INFO_INVALID 或与其等效的信息)。您一次只能指定仅下载、Ping 或仅上载中的一个参数。如果将这些参数中的多个参数设置为 true,则同步函数将返回错误(SQLE_SYNC_INFO_INVALID 或与其等效的信息)。