ADO 2.1 で使用するために、指定されたレコードセットを接続文字列で指定されたデータベースと同期します。
重要
Windows 8 および Windows Server 2012 以降では、RDS サーバー コンポーネントは Windows オペレーティング システムに含まれません (詳細については、Windows 8 と Windows Server 2012 の互換性クックブック を参照してください)。 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
この文字列は、この実行で使用されるハンドラーを識別します。 文字列には 2 つの部分が含まれています。 最初の部分には、使用するハンドラーの名前 (ProgID) が含まれています。 文字列の 2 番目の部分には、ハンドラーに渡される引数が含まれています。 引数文字列の解釈方法はハンドラー固有です。 2 つの部分は、文字列内のコンマの最初のインスタンスで区切られます。 引数文字列には、追加のコンマを含めることができます。 引数は省略可能です。
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 メソッド (RDS) のバージョンです。 Synchronize メソッドを使用して ADO 2.1 と通信する必要がある場合は、代わりに Synchronize21 メソッドを呼び出すことができます。 ADO 2.5 以降の Synchronize メソッドの機能は、ADO 2.1 の同じメソッドに対して提供される機能のスーパーセットです。