Cancel 方法(复制)

应用程序可以调用 Cancel 方法来取消当前正在进行的同步操作。

语法

object.Cancel()

适用范围

SQL Server Compact 3.5 Replication 对象

原型

HRESULT Cancel();

返回值

返回代码

说明

S_OK

方法已成功。

Any FAILED(HRESULT)

有关详细的错误信息,请参阅 SSCEErrors 集合。

注释

在同步开始后,此方法可以同步运行。Cancel 方法可以从其他线程运行,也可以从 复制状态报告接口 的用户实现运行。

调用 Cancel 方法后,取消行为将取决于当前进行的同步阶段,具体条件如下所列:

取消同步时的阶段

发生的行为

在完成 .IN 消息和调用 SQL Server 协调器前的上载阶段

完全取消同步。

在完成 .IN 消息和调用 SQL Server 协调器后

只取消同步过程的下载阶段。生成但不下载 .OUT 消息,并且在清除过程中最终删除该消息。

在创建 .OUT 消息后正在下载该消息时

某些更改可能会丢失,但不一定是全部。

请参阅

其他资源

Replication 对象的方法

复制状态报告接口