Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.
请求 dbmlsync 服务器执行同步。
public virtual DBSC_SyncHdl Sync( const char * profile_name, const char * extra_opts )
profile_name 在远程数据库中定义的包含同步选项的同步配置文件的名称。如果 profile_name 为空值,则不会使用配置文件并且 extra_opts 参数应包含所有用于同步的选项。
extra_opts 根据为同步配置文件定义选项字符串所使用的相同规则形成的字符串,指定为分号分隔的格式为 <选项名称>="">=<选项值>=""> 的元素列表。如果 profile_name 为非空值,则由 extra_opts 指定的选项将被添加到由 profile_name 指定的同步配置文件中的选项中。如果字符串中的选项已在配置文件中存在,那么字符串的值会替换已存储在配置文件中的值。如果 profile_name 为空值,则 extra_opts 应为同步指定所有选项。请参见CREATE SYNCHRONIZATION PROFILE 语句 [MobiLink]。
唯一标识此同步请求的 DBSC_SyncHdl 值只在客户端断开与服务器的连接之前有效。如果错误阻止了对同步请求的创建,则返回 NULL_SYNCHDL。返回 NULL_SYNCHDL 时,您可调用 GetErrorInfo 方法获取有关失败的详细信息。
只有连接到服务器才能调用此方法。profile_name 和 extra_opts 中至少一个必须为非空值。
返回值标识同步请求并可用于取消该请求或处理同步返回的事件