IBackgroundCopyJob::SetNoProgressTimeout 方法 (bits.h)

设置 BITS 在发生暂时性错误条件后尝试传输文件的时长。 如果存在进度,则会重置计时器。

Syntax

HRESULT SetNoProgressTimeout(
  [in] ULONG Seconds
);

参数

[in] Seconds

BITS 在发生第一个暂时性错误后尝试传输文件的时长(以秒为单位)。 默认重试期为 1,209,600 秒(14 天)。 将重试期设置为 0,以防止重试,并强制作业进入所有错误的BG_JOB_STATE_ERROR状态。 如果重试周期值超过 JobInactivityTimeout 组策略值(默认值 90 天),则 BITS 在超过策略值后取消作业。

返回值

此方法返回以下 HRESULT 值以及其他值。

返回代码 Description
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 服务。

要求

Requirement 价值
最低支持的客户端 Windows XP
支持的最低服务器 Windows Server 2003
目标平台 Windows操作系统
Header bits.h
Library Bits.lib
DLL QmgrPrxy.dll

另请参阅

IBackgroundCopyJob::GetNoProgressTimeout

IBackgroundCopyJob::SetMinimumRetryDelay