IBackgroundCopyJob::SetNoProgressTimeout 方法 (bits.h)
设置发生暂时性错误条件后 BITS 尝试传输文件的时间长度。 如果有进度,则重置计时器。
语法
HRESULT SetNoProgressTimeout(
[in] ULONG Seconds
);
参数
[in] Seconds
出现第一个暂时性错误后 BITS 尝试传输文件的时间长度(以秒为单位)。 默认重试时间为 1,209,600 秒, (14 天) 。 将重试期设置为 0 以防止重试,并强制作业进入所有错误的BG_JOB_STATE_ERROR状态。 如果重试周期值超过 JobInactivityTimeout 组策略值 (90 天默认) ,则 BITS 在超过策略值后取消作业。
返回值
此方法返回以下 HRESULT 值以及其他值。
返回代码 | 说明 |
---|---|
|
已成功设置重试时段。 |
|
作业的状态不能BG_JOB_STATE_CANCELLED或BG_JOB_STATE_ACKNOWLEDGED。 |
注解
如果 BITS 在重试期间未取得进展,则会将作业状态从BG_JOB_STATE_TRANSIENT_ERROR移动到BG_JOB_STATE_ERROR。 如果请求错误通知,则 BITS 会调用 JobError 回调。
注意 更改系统时钟不会影响重试时间。 例如,如果重试期在 14 天后过期,将系统时钟向前移动 14 天或更长时间并不意味着重试期提前过期,重试期仍将在 14 天后过期。 若要反映 BITS 中的系统时钟更改,必须重新启动计算机或 BITS 服务。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP |
最低受支持的服务器 | Windows Server 2003 |
目标平台 | Windows |
标头 | bits.h |
Library | Bits.lib |
DLL | QmgrPrxy.dll |