Cancel メソッド (レプリケーション)
Cancel メソッドは、実行中の同期をキャンセルするときに呼び出します。
構文
object.Cancel()
適用対象
SQL Server 2005 Compact Edition Replication オブジェクト
プロトタイプ
HRESULT Cancel();
戻り値
| リターン コード | 説明 |
|---|---|
S_OK |
メソッドが成功しました。 |
FAILED (HRESULT) |
エラーの詳細については、SSCEErrors コレクションを参照してください。 |
解説
同期が開始されると、同期的に実行されます。Cancel メソッドは、別のスレッドまたはレプリケーション ステータス レポート インターフェイスのユーザー実装から実行できます。
Cancel メソッドが呼び出されたときに、同期のどの段階が処理中であるかに応じて、キャンセルの動作が異なります。
| 同期のキャンセルのタイミング | キャンセルの動作 |
|---|---|
アップロードの段階において、.IN メッセージの完了前で、SQL Server 調整エージェントが起動する前 |
同期は、完全にキャンセルされます。 |
.IN メッセージが完了し、SQL Server 調整エージェントが起動した後 |
同期のダウンロード部分だけがキャンセルされます。.OUT メッセージが生成されますが、ダウンロードされないので、最終的にクリーンアップ プロセスで削除されます。 |
.OUT メッセージの作成後で、ダウンロード中 |
変更のすべてではなく、一部が使用される可能性があります。 |