Synchronize21 方法 (RDS)
將指定的資料錄集與連接字串所指定的資料庫進行同步,即可與 ADO 2.1 搭配使用。
重要
從 Windows 8 和 Windows Server 2012 開始,Windows 作業系統中不再包含 RDS 伺服器元件 (請參閱 Windows 8 和 Windows Server 2012 相容性操作手冊以取得詳細資訊)。 未來的 Windows 版本將移除 RDS 用戶端元件。 請避免在新的開發工作中使用這項功能,並規劃修改目前使用這項功能的應用程式。 使用 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,在未設定 Refresh 或 RefreshConflicts 時,傳回資料列狀態。
4=Refresh,資料錄集會以資料庫中目前的資料重新整理。 擱置中的更新,將不會推送至資料庫。 如果未設定此位元,則不會重新整理資料錄集,且所有擱置中的更新,都會推送至資料庫。
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 方法是同步處理方法 (RDS) 的簡易版本。 在您需要使用 Synchronize 方法與 ADO 2.1 通訊時,可以改為呼叫 Synchronize21 方法。 ADO 2.5 和更新版本中 Synchronize 方法的功能,是 ADO 2.1 中針對相同方法所提供的功能聯集。