从传输队列中删除作业,并从客户端(下载)和服务器(上传)中删除相关的临时文件。
Syntax
HRESULT Cancel();
返回值
此方法返回以下 HRESULT 值以及其他值。
| 返回代码 | Description |
|---|---|
|
作业已成功取消。 |
|
作业已成功取消;但是,该服务无法删除与作业关联的临时文件。 |
|
无法取消其状态为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 |