a_remote_sql 结构

typedef struct a_remote_sql

成员名称	类型	说明
apply	a_bit_field	通常设置为 TRUE。如果未设置，将扫描消息，但不会应用消息。与 dbremote -a 选项对应。
argv	char **	指向所分析命令行的指针（字符串指针矢量）。如果不为 NULL，则 DBRemoteSQL 将调用消息例程来显示前缀不是 -c、-cq 或 -ek 的每个命令行参数。
batch	a_bit_field	如果设置为 TRUE，将强制在应用消息和扫描日志后退出（这与至少有一个具有 [always] 发送时间的用户的情况相同）。清除后，将允许由远程用户的发送次数决定运行模式。
confirmrtn	MSG_CALLBACK	确认请求回调例程的地址或 NULL。
connectparms	char *	连接到数据库所需的参数。它们采用如下所示的连接字符串形式："UID=DBA;PWD=sql;DBF=demo.db"。数据库服务器将由连接字符串的 START 参数启动。例如："START=c:\SQLAny12\bin32\dbeng12.exe"。一个包括 START 参数的完整连接字符串示例："UID=DBA;PWD=sql;DBF=demo.db;START=c:\SQLAny12\bin32\dbeng12.exe"。
debug	a_bit_field	如果设置为 TRUE，将包含调试输出。
debug_dump_size	a_sql_uint32	留作内部使用且必须设置为 0。
debug_page_offsets	a_bit_field	留作内部使用且必须设置为 FALSE。
default_window_title	char *	指向缺省窗口标题字符串的指针。
deleted	a_bit_field	通常设置为 TRUE。如果未设置，消息被应用后不会被删除。与 dbremote -p 选项对应。
encryption_key	char *	指向加密密钥的指针。与 dbremote -ek 选项对应。
errorrtn	MSG_CALLBACK	错误消息回调例程的地址或 NULL。
frequency	a_sql_uint32	设置进来的消息的轮询频率。此值应设置为 max( 1, receive_delay/60 )。请参见下面的 receive_delay。
full_q_scan	a_bit_field	留作内部使用且必须设置为 FALSE。
include_scan_range	char *	留作内部使用且必须设置为 NULL。
latest_backup	a_bit_field	如果设置为 TRUE，将仅处理备份日志。不发送来自活动日志的操作。与 dbremote -u 选项对应。
link_debug	a_bit_field	如果设置为 TRUE，将打开对链接的调试。
locale	char *	留作内部使用且必须设置为 NULL。
log_file_name	const char *	指向 DBRemoteSQL 输出日志的名称的指针，消息回调会将其输出打印到该输出日志。如果将 send 设置为 true，会将错误日志发送到统一数据库（除非此指针为 NULL）。
log_size	a_sql_uint32	当联机事务日志的大小大于此值时，DBRemoteSQL 将重命名并重新启动联机事务日志。与 dbremote -x 选项对应。
logrtn	MSG_CALLBACK	指向将给定消息打印到日志文件的函数的指针。这些消息无需用户进行查看。
max_length	a_sql_uint32	设置为消息可具有的最大长度（以字节为单位）。这会影响发送和接收。建议值为 50000。与 dbremote -l 选项对应。
memory	a_sql_uint32	设置为在建立要发送的消息时所使用的内存缓冲区的最大大小（以字节为单位）。建议值至少为 2 * 1024 * 1024。与 dbremote -m 选项对应。
mirror_logs	char *	指向目录名称的指针，该目录包含脱机镜像事务日志。与 dbremote -ml 选项对应。
more	a_bit_field	应设置为 TRUE。
msgqueuertn	MSG_QUEUE_CALLBACK	当 DBRemoteSQL 要休眠时调用的函数。该参数指定休眠周期（以毫秒为单位）。正如 dllapi.h 中的定义，此函数应返回以下值。 MSGQ_SLEEP_THROUGH，指示例程休眠请求的毫秒数。通常这是应返回的值。 MSGQ_SHUTDOWN_REQUESTED，指示希望尽快终止同步。
msgrtn	MSG_CALLBACK	信息消息回调例程的地址或 NULL。
no_user_interaction	a_bit_field	如果设置为 TRUE，将不请求用户交互。
operations	a_sql_uint32	当应用消息时会使用此值。在 DBRemoteSQL 至少具有此数量的未提交操作（插入、删除、更新）之前，提交将被忽略。与 dbremote -g 选项对应。
patience_retry	a_sql_uint32	设置为 DBRemoteSQL 在假定所期待的消息丢失之前应等待的轮询进来的消息的次数。例如，如果 patience_retry 为 3，则 DBRemoteSQL 尝试最多三次来接收缺失的消息。然后，它会发送一个重新发送请求。建议值为 1。与 dbremote -rp 选项对应。
progress_index_rtn	SET_PROGRESS_CALLBACK	指向更新进度条状态的函数的指针。该函数具有两个无符号整型变量 index 和 max。第一次调用时，这两个值分别为最小和最大值（如 0、100）。后续调用时，第一个参数为当前索引值（例如，0 到 100 之间的值），而第二个参数始终为 0。
progress_msg_rtn	MSG_CALLBACK	指向显示进程消息的函数的指针。
queueparms	char *	留作内部使用且必须设置为 NULL。
receive	a_bit_field	如果设置为 TRUE，将会接收消息。如果将 receive 和 send 均设置为 FALSE，则两者均被认为是 TRUE。建议将 receive 和 send 设置为 FALSE。对应 dbremote -r 选项。
receive_delay	a_sql_uint32	设置为在轮询之间等待新进来的消息的时间（以秒为单位）。建议值为 60。与 dbremote -rd 选项对应。
remote_output_file_name	char *	指向 DBRemoteSQL 远程输出文件的名称的指针。与 dbremote -ro 或 -rt 选项对应。
rename_log	a_bit_field	如果设置为 TRUE，将对日志进行重命名和重新启动（仅适用于 DBRemoteSQL）。
resend_urgency	a_sql_uint32	设置 DBRemoteSQL 在知道用户需要重新扫描之后，在执行完全日志扫描之前所等待的时间（以秒为单位）。设置为零可允许 DBRemoteSQL 根据用户发送时间及其收集的其它信息选择一个合适的值。与 dbremote -ru 选项对应。
scan_log	a_bit_field	留作内部使用且必须设置为 FALSE。
send	a_bit_field	如果设置为 TRUE，将会发送消息。如果将 receive 和 send 均设置为 FALSE，则两者均被认为是 TRUE。建议将 receive 和 send 设置为 FALSE。对应 dbremote -s 选项。
send_delay	a_sql_uint32	设置扫描日志文件以查找要发送的新操作的时间间隔（以秒为单位）。设置为零可允许 DBRemoteSQL 根据用户发送时间选择一个合适的值。与 dbremote -sd 选项对应。
set_window_title_rtn	SET_WINDOW_TITLE_CALLBACK	指向一个重置窗口标题的函数的指针（仅适用于 Windows）。标题可以是 "database_name（接收、扫描或发送）- default_window_title"。
threads	a_sql_uint32	设置应当用于应用消息的工作线程的数目。此值不能超过 50。与 dbremote -w 选项对应。
transaction_logs	char *	应使用脱机事务日志标识目录（仅适用于 DBRemoteSQL）。与 dbremote 的 transaction_logs_directory 参数对应。
triggers	a_bit_field	多数情况下，通常不会进行设置 (FALSE)。如果设置为 TRUE，将复制触发器操作。使用前应当谨慎考虑。
truncate_remote_output_file	a_bit_field	如果设置为 TRUE，远程输出文件将被截断，而不会进行附加。与 dbremote -rt 选项对应。
unused	a_bit_field	留作内部使用且必须设置为 FALSE。
use_hex_offsets	a_bit_field	如果设置为 TRUE，会使用十六进制表示法显示日志偏移；否则将使用十进制表示法。
use_relative_offsets	a_bit_field	如果设置为 TRUE，将以相对于当前日志文件开始位置的方式显示日志偏移。如果设置为 FALSE，将显示从开始时间起的日志偏移。
verbose	a_bit_field	如果设置，将生成额外的信息。与 dbremote -v 选项对应。
version	unsigned short	DBTools 版本号 (DB_TOOLS_VERSION_NUMBER)。
warningrtn	MSG_CALLBACK	指向用于显示给定警告消息的函数的指针。如果为 NULL，将改为调用 errorrtn 函数。

dbremote 实用程序在处理任何命令行选项前会设置以下缺省值：

version = DB_TOOLS_VERSION_NUMBER
argv =（传递给应用程序的变量矢量）
deleted = TRUE
apply = TRUE
more = TRUE
link_debug = FALSE
max_length = 50000
memory = 2 * 1024 * 1024
frequency = 1
threads = 0
receive_delay = 60
send_delay = 0
log_size = 0
patience_retry = 1
resend_urgency = 0
log_file_name =（从命令行进行设置）
truncate_remote_output_file = FALSE
remote_output_file_name = NULL
no_user_interaction = TRUE（如果没有可用的用户界面）
errorrtn =（相应例程的地址）
msgrtn =（相应例程的地址）
confirmrtn =（相应例程的地址）
msgqueuertn =（相应例程的地址）
logrtn =（相应例程的地址）
warningrtn =（相应例程的地址）
set_window_title_rtn =（相应例程的地址）
progress_msg_rtn =（相应例程的地址）
progress_index_rtn =（相应例程的地址）

DBRemoteSQL 方法 [数据库工具]

a_remote_sql 结构

语法

成员

注释

另请参见