IBackgroundCopyJob::Cancel 方法 (bits.h)

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

Syntax

HRESULT Cancel();

返回值

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

返回代码 Description
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,该方法将取消答复。

要求

Requirement 价值
最低支持的客户端 Windows XP
支持的最低服务器 Windows Server 2003
目标平台 Windows操作系统
Header bits.h
Library Bits.lib
DLL QmgrPrxy.dll

另请参阅

IBackgroundCopyJob::Complete

IBackgroundCopyJob::Resume

IBackgroundCopyJob::Suspend