应用程序可以调用 Cancel 方法来取消当前正在进行的同步操作。
语法
object.Cancel()
适用范围
SQL Server 2005 Compact Edition Replication 对象
原型
HRESULT Cancel();
返回值
| 返回代码 | 说明 | 
|---|---|
| S_OK | 方法已成功。 | 
| Any FAILED(HRESULT) | 有关详细的错误信息,请参阅 SSCEErrors 集合。 | 
备注
在同步开始后,此方法可以同步运行。Cancel 方法可以从其他线程运行,也可以从 复制状态报告接口 的用户实现运行。
调用 Cancel 方法后,取消行为将取决于当前进行的同步阶段,具体条件如下所列:
| 取消同步时的阶段 | 发生的行为 | 
|---|---|
| 在完成 .IN 消息和调用 SQL Server 协调器前的上载阶段 | 完全取消同步。 | 
| 在完成 .IN 消息和调用 SQL Server 协调器后 | 只取消同步过程的下载阶段。生成但不下载 .OUT 消息,并且在清除过程中最终删除该消息。 | 
| 在创建 .OUT 消息后正在下载该消息时 | 某些更改可能会丢失,但不一定是全部。 |