设置 BITS 在发生暂时性错误条件后尝试传输文件的时长。 如果存在进度,则会重置计时器。
Syntax
HRESULT SetNoProgressTimeout(
[in] ULONG Seconds
);
参数
[in] Seconds
BITS 在发生第一个暂时性错误后尝试传输文件的时长(以秒为单位)。 默认重试期为 1,209,600 秒(14 天)。 将重试期设置为 0,以防止重试,并强制作业进入所有错误的BG_JOB_STATE_ERROR状态。 如果重试周期值超过 JobInactivityTimeout 组策略值(默认值 90 天),则 BITS 在超过策略值后取消作业。
返回值
此方法返回以下 HRESULT 值以及其他值。
| 返回代码 | Description |
|---|---|
|
已成功设置重试期。 |
|
作业的状态不能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 服务。
要求
| Requirement | 价值 |
|---|---|
| 最低支持的客户端 | Windows XP |
| 支持的最低服务器 | Windows Server 2003 |
| 目标平台 | Windows操作系统 |
| Header | bits.h |
| Library | Bits.lib |
| DLL | QmgrPrxy.dll |