Synchronize 方法 (RDS)
将给定的 Recordset 与连接字符串指定的数据库同步,以便在 ADO 2.5 及更高版本中使用。
重要
从 Windows 8 和 Windows Server 2012 开始,RDS 服务器组件不再包含在 Windows 操作系统中(有关详细信息,请参阅 Windows 8 和 Windows Server 2012 兼容性指南)。 RDS 客户端组件将在将来的 Windows 版本中删除。 避免在新开发工作中使用此功能,并计划修改当前使用此功能的应用程序。 使用 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 在 刷新 和 RefreshConflicts 均未设置时返回行状态。
4=刷新 记录集使用数据库中的当前数据刷新。 挂起的更新不会推送到数据库。 如果未设置此位,则不会刷新记录集,并将任何挂起的更新推送到数据库。
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 检查连接和查询字符串的方向。