Synchronize21 方法 (RDS)

将给定记录集与连接字符串指定的数据库同步,以用于 ADO 2.1。

重要

从 Windows 8 和 Windows Server 2012 开始,RDS 服务器组件不再包含在 Windows 操作系统中(有关详细信息,请参阅 Windows 8 和 Windows Server 2012 兼容性指南)。 RDS 客户端组件将在将来的 Windows 版本中删除。 避免在新开发工作中使用此功能,并计划修改当前使用此功能的应用程序。 使用 RDS 的应用程序应迁移到 WCF 数据服务

语法

  
object.Synchronize21(ConnectionString As String, HandlerString As String, lSynchronizeOptions As Long, ppRecordset As Object, pStatusArray)  

参数

ConnectionString
用于连接到将发送请求的 OLE DB 访问接口的字符串。 如果使用处理程序,处理程序可以编辑或替换连接字符串。

HandlerString
该字符串标识要用于此执行的处理程序。 字符串包含两个部分。 第一部分包含要使用的处理程序的名称(ProgID)。 字符串的第二部分包含要传递给处理程序的参数。 如何解释参数字符串是特定于处理程序的。 这两个部分由字符串中逗号的第一个实例分隔。 参数字符串可以包含其他逗号。 参数是可选的。

lSynchronizeOptions
同步选项的位掩码。

1=UpdateTransact 对数据库的更新包装在事务中。 如果任何更新失败,事务将中止。

2=RefreshWithUpdate刷新RefreshConflicts 均未设置时返回行状态。

4=刷新 记录集使用数据库中的当前数据刷新。 挂起的更新不会推送到数据库。 如果未设置此位,则不会刷新记录集,并将任何挂起的更新推送到数据库。

8=RefreshConflicts 任何挂起更改的行都无法更新。 无法更新的行使用数据库中的当前数据刷新。

ppRecordset
指向要同步的记录集的指针的指针。

pStatusArray
一个变体,用于返回受同步影响的行的安全行状态数组。 如果未设置以下任何同步选项:RefreshWithUpdateRefreshRefreshConflicts

言论

HandlerString 参数可以为 null。 在这种情况下会发生什么情况取决于 RDS 服务器的配置方式。 “MSDFMAP.handler”的处理程序字符串指示应使用Microsoft提供的处理程序(Msdfmap.dll)。 “MASDFMAP.handler,sample.ini” 的处理程序字符串指示应使用 Msdfmap.dll 处理程序,并将参数“sample.ini”传递给处理程序。 然后,Msdfmap.dll 将参数解释为使用 sample.ini 检查连接和查询字符串的方向。

注意

Synchronize21 方法只是 同步方法 (RDS)的版本。 如果需要使用 Synchronize 方法与 ADO 2.1 通信,可以改为调用 Synchronize21 方法。 ADO 2.5 及更高版本中的 Synchronize 方法的功能是 ADO 2.1 中为相同方法提供的功能的超集。

适用于

DataFactory 对象 (RDSServer)