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