a_sync_db 结构

typedef struct a_sync_db

成员名称	类型	说明
allow_outside_connect	a_bit_field	保留；使用 0。
allow_schema_change	a_bit_field	如果设置为 TRUE，将检查多个同步之间的模式更改。相当于 dbmlsync -sc 选项。
apply_dnld_file	const char *	要应用的下载文件的名称。相当于 dbmlsync -ba 选项，如果未指定选项，则为 NULL。
argv	char **	用于此次运行的 argv 数组，此数组的最后一个元素必须为 NULL。
autoclose	a_bit_field	如果设置为 TRUE，将在完成时关闭窗口。相当于 dbmlsync -qc 选项。
background_retry	a_sql_int32	对被中断的后台同步操作的重试次数。相当于 dbmlsync -bkr 选项。
background_sync	a_bit_field	如果设置为 TRUE，将执行后台同步。相当于 dbmlsync -bk 选项。
cache_verbosity	a_bit_field	保留；使用 0。
ce_argv	char **	保留；使用 NULL。
ce_reproc_argv	char **	保留；使用 NULL。
changing_pwd	a_bit_field	如果设置新的 MobiLink 口令，则设置为 TRUE。请参见 new_mlpassword 字段。相当于 dbmlsync -mn 选项。
confirmrtn	MSG_CALLBACK	确认请求回调例程的地址或 NULL。
connectparms	char *	连接到数据库所需的参数。它们采用如下所示的连接字符串形式："UID=DBA;PWD=sql;DBF=demo.db"。数据库服务器将由连接字符串的 START 参数启动。例如："START=c:\SQLAny16\bin32\dbsrv16.exe"。一个包括 START 参数的完整连接字符串示例："UID=DBA;PWD=sql;DBF=demo.db;START=c:\SQLAny16\bin32\dbsrv16.exe"。
connectparms_allocated	a_bit_field	保留；使用 0。
continue_download	a_bit_field	如果设置为 TRUE，将继续上次失败的下载操作。相当于 dbmlsync -dc 选项。
create_dnld_file	const char *	要创建的下载文件的名称。相当于 dbmlsync -bc 选项，如果未指定选项，则为 NULL。
debug	a_bit_field	保留；使用 0。
debug_dump_char	a_bit_field	保留；使用 0。
debug_dump_hex	a_bit_field	保留；使用 0。
debug_dump_size	a_sql_uint32	保留；使用 0。
debug_page_offsets	a_bit_field	保留；使用 0。
default_window_title	char *	将要在窗口标题中显示的程序的名称（如 DBMLSync）。
dl_insert_width	a_sql_uint32	保留；使用 0。
dl_use_put	a_bit_field	保留；使用 0。
dlg_info_msg	a_sql_uint32	保留；使用 0。
dnld_fail_len	a_sql_uint32	保留；使用 0。
dnld_file_extra	const char *	指定要在下载文件中包含的额外字符串。相当于 dbmlsync -be 选项。
dnld_gen_num	a_bit_field	如果设置为 TRUE，将在应用下载文件时更新世代号。相当于 dbmlsync -bg 选项。
dnld_read_size	a_sql_uint32	设置下载读取大小。相当于 dbmlsync -drs 选项。
download_only	a_bit_field	如果设置为 TRUE，将执行仅下载同步。相当于 dbmlsync -ds 选项。
encrypted_stream_opts	const char *	保留；使用 NULL。
encryption_key	char *	数据库文件的加密密钥。相当于 dbmlsync -ek 选项。
entered_dialog	a_bit_field	保留；使用 0。
errorrtn	MSG_CALLBACK	错误消息回调例程的地址或 NULL。
est_upld_row_cnt	a_sql_uint32	设置预计的上载行计数（用于优化）。相当于 dbmlsync -urc 选项。
extended_options	char *	形式为“关键字=值;...”的扩展选项。相当于 dbmlsync -e 选项。
hide_conn_str	a_bit_field	如果设置为 FALSE，将显示连接字符串；设置为 TRUE，将隐藏连接字符串。相当于 dbmlsync -vc 选项。
hide_ml_pwd	a_bit_field	如果设置为 FALSE，将显示 MobiLink 口令；设置为 TRUE，将隐藏 MobiLink 口令。相当于 dbmlsync -vp 选项。
hovering_frequency	a_sql_uint32	设置日志扫描轮询周期（以秒为单位）。通常为 60。相当于 dbmlsync -pp 选项。
ignore_debug_interrupt	a_bit_field	保留；使用 0。
ignore_hook_errors	a_bit_field	如果设置为 TRUE，将忽略挂接函数中出现的错误。相当于 dbmlsync -eh 选项。
ignore_hovering	a_bit_field	如果设置为 TRUE，将禁止日志扫描轮询。相当于 dbmlsync -p 选项。
ignore_scheduling	a_bit_field	如果设置为 TRUE，将忽略调度。相当于 dbmlsync -is 选项。
include_scan_range	const char *	保留；使用 NULL。
init_cache	a_sql_uint32	初始高速缓存大小。相当于 dbmlsync -ci 选项。
init_cache_suffix	char	初始高速缓存大小的后缀（'B' 表示字节，'P' 表示百分比，如果未指定，则为 0）。
kill_other_connections	a_bit_field	如果设置为 TRUE，将删除与所同步表上的锁定的连接。相当于 dbmlsync -d 选项。
last_upload_def	a_syncpub *	保留；使用 NULL。
lite_blob_handling	a_bit_field	保留；使用 0。
log_file_name	const char *	数据库服务器消息日志文件名。相当于 dbmlsync -o 或 -ot 选项。
log_size	a_sql_uint32	在重命名和重新启动事务日志时日志文件的大小（以字节为单位）。对于未指定大小的文件，指定为 0。相当于 dbmlsync -x 选项。
logrtn	MSG_CALLBACK	只将消息写入日志文件的日志回调例程的地址或 NULL。
max_cache	a_sql_uint32	高速缓存大小的最大值。相当于 dbmlsync -cm 选项。
max_cache_suffix	char	最大高速缓存大小的后缀（'B' 表示字节，'P' 表示百分比，如果未指定，则为 0）。
min_cache	a_sql_uint32	高速缓存大小的最小值。相当于 dbmlsync -cl 选项。
min_cache_suffix	char	最小高速缓存大小的后缀（'B' 表示字节，'P' 表示百分比，如果未指定，则为 0）。
mlpassword	char *	MobiLink 口令，如果未指定选项，则为 NULL。相当于 dbmlsync -mp 选项。
msgqueuertn	MSG_QUEUE_CALLBACK	当 DBMLSync 要休眠时调用的函数。该参数指定休眠周期（以毫秒为单位）。正如 dllapi.h 中的定义，此函数应返回以下值。 MSGQ_SLEEP_THROUGH，指示例程休眠请求的毫秒数。通常这是应返回的值。 MSGQ_SHUTDOWN_REQUESTED，指示希望尽快终止同步。 MSGQ_SYNC_REQUESTED，指示例程休眠的时间少于请求的毫秒数，如果当前没有正在进行同步，则立即开始下一个同步。
msgrtn	MSG_CALLBACK	信息消息回调例程的地址或 NULL。
new_mlpassword	char *	新的 obiLink 口令，如果未指定选项，则为 NULL。相当于 dbmlsync -mn 选项。
no_offline_logscan	a_sql_uint32	如果设置为 TRUE，将禁止脱机日志扫描（不能与 –x 一起使用）。相当于 dbmlsync -do 选项。
no_schema_cache	a_bit_field	保留；使用 0。
no_stream_compress	a_bit_field	保留；使用 0。
offline_dir	const char *	事务日志目录。在 dbmlsync 命令行中指定的最后一项。
output_to_file	a_bit_field	保留；使用 0。
output_to_mobile_link	a_bit_field	保留；使用 1。
persist_connection	a_bit_field	如果设置为 TRUE，将保留多个同步之间的 MobiLink 连接。如果设置为 FALSE，将关闭多个同步之间的 MobiLink 连接。相当于 dbmlsync -pc{+\|-} 选项。
ping	a_bit_field	如果设置为 TRUE，将强制 MobiLink 服务器回应。相当于 dbmlsync -pi 选项。
preload_dlls	char *	保留；使用 NULL。
progress_index_rtn	SET_PROGRESS_CALLBACK	调用以用于更新进度条状态的函数。
progress_msg_rtn	MSG_CALLBACK	调用以用于改变状态窗口中进度条上的文本的函数。
prompt_again	a_bit_field	保留；使用 0。
prompt_for_encrypt_key	a_bit_field	保留；使用 0。
protocol_add_cli_bit_to_cli_both	a_bit_field	保留；使用 0。
protocol_add_cli_bit_to_cli_max	a_bit_field	保留；使用 0。
protocol_add_serv_bit_to_cli_both	a_bit_field	保留；使用 0。
protocol_add_serv_bit_to_cli_max	a_bit_field	保留；使用 0。
protocol_add_serv_bit_to_serv_both	a_bit_field	保留；使用 0。
protocol_add_serv_bit_to_serv_max	a_bit_field	保留；使用 0。
raw_file	const char *	保留；使用 NULL。
rename_log	a_bit_field	如果设置为 TRUE，将对事务日志进行重命名和重新启动。请参见 log_size 字段。相当于 dbmlsync -x 选项。
reserved	a_bit_field	保留；使用 0。
retry_remote_ahead	a_bit_field	如果远程偏移大于统一偏移，则设置为 TRUE 以便在进程不匹配时使用远程偏移重新发送上载。相当于 dbmlsync -ra 选项。
retry_remote_behind	a_bit_field	如果设置为 TRUE，将在进程不匹配时使用远程偏移重新发送上载。如果远程偏移小于统一偏移。相当于 dbmlsync -r 或 -rb 选项。
server_mode	a_bit_field	如果设置为 TRUE，将在服务器模式下运行。相当于 dbmlsync -sm 选项。
server_port	a_sql_uint32	在服务器模式下运行时，用于设置通信端口。相当于 dbmlsync -po 选项。
set_window_title_rtn	SET_WINDOW_TITLE_CALLBACK	通过对其调用可更改 dbmlsync 窗口标题的函数（仅限 Windows）。
status_rtn	STATUS_CALLBACK	保留；使用 NULL。
strictly_free_memory	a_bit_field	保留；使用 0。
strictly_ignore_trigger_ops	a_bit_field	保留；使用 0。
sync_opt	char *	保留；使用 NULL。
sync_params	char *	用户验证参数。相当于 dbmlsync -ap 选项。
sync_profile	char *	要执行的同步配置文件。相当于 dbmlsync -sp 选项。
trans_upload	a_bit_field	如果设置为 TRUE，将分别上载每个数据库事务。相当于 dbmlsync -tu 选项。
upld_fail_len	a_sql_uint32	保留；使用 0。
upload_defs	a_syncpub *	要同步的发布/预订的链接列表。
upload_only	a_bit_field	如果设置为 TRUE，将执行仅上载同步。相当于 dbmlsync -uo 选项。
usage_rtn	USAGE_CALLBACK	保留；使用 NULL。
use_fixed_cache	a_bit_field	保留；使用 0。
use_hex_offsets	a_bit_field	保留；使用 0。
use_relative_offsets	a_bit_field	保留；使用 0。
used_dialog_allocation	a_bit_field	保留；使用 0。
user_name	char *	要同步的 MobiLink 用户（不建议使用）。相当于 dbmlsync -u 选项。
verbose	a_bit_field	保留；使用 0。
verbose_download	a_bit_field	保留；使用 0。
verbose_download_data	a_bit_field	保留；使用 0。
verbose_hook	a_bit_field	如果设置为 TRUE，将显示挂接脚本信息。相当于 dbmlsync -vs 选项。
verbose_minimum	a_bit_field	如果设置为 TRUE，会将详细程度设置为最小。相当于 dbmlsync -v 选项。
verbose_msgid	a_bit_field	如果设置为 TRUE，将显示消息 ID。相当于 dbmlsync -vi 选项。
verbose_option_info	a_bit_field	如果设置为 TRUE，将显示命令行和扩展选项。相当于 dbmlsync -vo 选项。
verbose_protocol	a_bit_field	保留；使用 0。
verbose_row_cnts	a_bit_field	如果设置为 TRUE，将显示上载/下载行计数。相当于 dbmlsync -vn 选项。
verbose_row_data	a_bit_field	如果设置为 TRUE，将显示上载/下载行值。相当于 dbmlsync -vr 选项。
verbose_server	a_bit_field	保留；使用 0。
verbose_upload	a_bit_field	如果设置为 TRUE，将显示上载流信息。相当于 dbmlsync -vu 选项。
verbose_upload_data	a_bit_field	保留；使用 0。
version	unsigned short	DBTools 版本号 (DB_TOOLS_VERSION_NUMBER)。
warningrtn	MSG_CALLBACK	调用以用于显示警告消息的函数。

有些成员与可从 dbmlsync 命令行实用程序访问的功能相对应。应根据数据类型为未使用的成员指派值 0、FALSE 或 NULL。

a_sync_db 结构

语法

成员

注释

另请参见