Synchronize 方法 (RDS)
将给定记录集与连接字符串指定的数据库同步以便在 ADO 2.5 和更高版本结合使用。
重要
从 Windows 8 和 Windows Server 2012 开始,Windows 操作系统不再包含 RDS 服务器组件(有关更多详细信息,请参阅 Windows 8 和 Windows Server 2012 兼容性实用手册)。 Windows 的未来版本中将移除 RDS 客户端组件。 请避免在新的开发工作中使用该功能,并着手修改当前还在使用该功能的应用程序。 使用 RDS 的应用程序应迁移到 WCF 数据服务。
语法
object.Synchronize(ConnectionString As String, HandlerString As String, lSynchronizeOptions As Long, ppRecordset As Object, pStatusArray, [lcid As Long], [pInformation)
参数
ConnectionString
用于连接到 OLE DB 提供程序的字符串,将在该提供程序中发送请求。 如果使用处理程序,那么处理程序可以编辑或替换连接字符串。
HandlerString
该字符串标识要用于此执行的处理程序。 字符串包含两个部分。 第一部分包含要使用的处理程序的名称 (ProgID)。 字符串的第二部分包含要传递给处理程序的参数。 如何解释参数字符串是特定于处理程序的。 这两部分由字符串中的第一个逗号分隔(尽管参数字符串可能包含额外的逗号)。 参数是可选的。
lSynchronizeOptions
同步选项的位掩码。
1=UpdateTransact 对数据库的更新包装在事务中。 如果任何更新失败,则中止事务。
2=RefreshWithUpdate 在未设置 Refresh 和 RefreshConflicts 时导致返回行状态。
4=Refresh 使用数据库中的当前数据刷新记录集。 挂起的更新不会推送到数据库。 如果未设置此位,则不会刷新记录集,并将任何挂起的更新推送到数据库。
8=RefreshConflicts 具有挂起更改的任何行都无法更新。 使用数据库中的当前数据刷新无法更新的行。
ppRecordset
指向要同步的记录集的指针。
pStatusArray
一个变量,用于返回受同步影响的行的安全行状态数组。 如果未设置以下同步选项,则不设置:RefreshWithUpdate、Refresh 和RefreshConflicts。
lcid
LCID 用于生成 pInformation 中返回的任何错误。
pInformation
指向 Execute 返回的信息错误的指针。 如果为 NULL,则不返回错误信息。
备注
HandlerString 参数可以为 null。 在这种情况下会发生什么取决于 RDS 服务器的配置方式。 “MSDFMAP.handler”的处理程序字符串指示应使用 Microsoft 提供的处理程序 (Msdfmap.dll)。 “MASDFMAP.handler,sample.ini”的处理程序字符串指示应使用 Msdfmap.dll 处理程序,并应将参数“sample.ini”传递给处理程序。 然后,Msdfmap.dll 会将参数解释为使用 sample.ini 检查连接和查询字符串的方向。