IBackgroundCopyJob：：Cancel 方法 (bits.h)

  • 项目

从传输队列中删除作业，并从客户端中删除相关的临时文件， (下载) 和服务器 (上传) 。

语法

HRESULT Cancel();

返回值

此方法返回以下 HRESULT 值以及其他值。

返回代码 说明
S_OK
 作业已成功取消。
BG_S_UNABLE_TO_DELETE_FILES
 作业已成功取消;但是，该服务无法删除与作业关联的临时文件。
BG_E_INVALID_STATE
 无法取消状态为BG_JOB_STATE_CANCELLED或BG_JOB_STATE_ACKNOWLEDGED的作业。

注解

可以随时 取消作业 ;但是，作业在取消后无法恢复。

对于上传作业，如果服务器不可用，则 BITS 从队列中删除作业之前可能会有延迟。 BITS 会定期向 BITS 服务器发送最多 24 小时的取消请求。 如果服务器在 24 小时内未响应，则 BITS 将从队列中删除作业。 如果 无进度超时期限 小于 24 小时，则 BITS 使用无进度超时期限来限制重试次数。

如果上传未完成， 则 Cancel 方法将取消上传。 如果上传已完成，并且作业的类型为 BG_JOB_TYPE_UPLOAD_REPLY，则 方法将取消答复。

要求

要求 值
最低受支持的客户端 Windows XP
最低受支持的服务器 Windows Server 2003
目标平台 Windows
标头 bits.h
Library Bits.lib
DLL QmgrPrxy.dll

另请参阅

IBackgroundCopyJob：：Complete

IBackgroundCopyJob：：Resume

IBackgroundCopyJob：：Suspend