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