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