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 值以及其他值。

返回代码 说明
S_OK
 已成功设置重试时段。
BG_E_INVALID_STATE
 作业的状态不能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

另请参阅

IBackgroundCopyJob：：GetNoProgressTimeout

IBackgroundCopyJob：：SetMinimumRetryDelay