Synchronize21 メソッド (RDS)
指定したレコードセットを、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=RefreshWithUpdateRefresh も 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 メソッドは、単に 1 つのバージョンの Synchronize メソッド (RDS) です。 Synchronize メソッドを使用して ADO 2.1 と通信する必要がある場合は、代わりに Synchronize21 メソッドを呼び出すことができます。 ADO 2.5 以降の Synchronize メソッドの機能は、ADO 2.1 の同じメソッドに対して提供される機能のスーパーセットです。