Synchronize21 方法 (RDS)
將指定的記錄集與連接字串所指定的資料庫同步處理,以搭配 ADO 2.1 使用。
重要
從 Windows 8 和 Windows Server 2012 開始,RDS 伺服器元件已不再包含在 Windows 作業系統中(如需詳細資訊,請參閱 Windows 8 和 Windows Server 2012 兼容性 Cookbook)。 RDS 用戶端元件將在未來的 Windows 版本中移除。 請避免在新的開發工作中使用此功能,並計劃修改目前使用此功能的應用程式。 使用 RDS 的應用程式應該移至 WCF Data Service。
語法
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 當未設定 refresh 或 RefreshConflicts 時,都會傳回數據列狀態。
4=重新整理 記錄集會使用資料庫中的目前數據重新整理。 擱置的更新不會推送至資料庫。 如果未設定此位,則不會重新整理記錄集,並將任何擱置的更新推送至資料庫。
8=RefreshConflicts 任何暫止變更的數據列都無法更新。 無法更新的數據列會以資料庫目前的數據重新整理。
ppRecordset
要同步處理之記錄集指標的指標。
pStatusArray
變數,用來傳回受同步處理影響之數據列之數據列狀態的安全數位。 如果未設定下列任何同步處理選項,則不會設定:RefreshWithUpdate、Refresh 和 RefreshConflicts。
言論
HandlerString 參數可以是 null。 在此情況下,會發生什麼情況取決於 RDS 伺服器的設定方式。 “MSDFMAP.handler” 的處理程式字串表示應該使用Microsoft提供的處理程式(Msdfmap.dll)。 “MASDFMAP.handler,sample.ini” 的處理程式字串表示應該使用 Msdfmap.dll 處理程式,而且應該將自變數 “sample.ini” 傳遞給處理程式。 Msdfmap.dll 接著會將自變數解譯為使用 sample.ini 檢查連線和查詢字串的方向。
注意
Synchronize21 方法只是 Synchronize 方法的版本。 如果您需要使用 Synchronize 方法來與 ADO 2.1 通訊,則可以改為呼叫 Synchronize21 方法。 ADO 2.5 和更新版本中 Synchronize 方法的功能是針對 ADO 2.1 中相同方法所提供的功能超集。