IBackgroundCopyJob::SetMinimumRetryDelay 方法 (bits.h)

设置 BITS 在尝试传输文件之前遇到暂时性错误条件后等待的最短时间长度。

Syntax

HRESULT SetMinimumRetryDelay(
  [in] ULONG Seconds
);

参数

[in] Seconds

BITS 在尝试传输文件之前遇到暂时性错误后等待的最短时间长度(以秒为单位)。 默认重试延迟为 600 秒(10 分钟)。 可以指定的最小重试延迟为 5 秒。 如果指定的值小于 5 秒,则 BITS 会将该值更改为 5 秒。 如果该值超过从 GetNoProgressTimeout 方法检索到的无进度超时值,则 BITS 不会重试传输并将作业移动到BG_JOB_STATE_ERROR状态。

返回值

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

返回代码 Description
S_OK
已成功设置重试延迟。
BG_E_INVALID_STATE
作业的状态不能BG_JOB_STATE_CANCELLED或BG_JOB_STATE_ACKNOWLEDGED。

注解

若要在最小重试期到期之前启动作业,请调用 IBackgroundCopyJob::Resume 方法。

如果发生网络断开连接或磁盘锁定错误(例如 chkdsk 正在运行),或者 MaxInternetBandwidth 组策略为零,则 BITS 不会重试作业。

注意 更改系统时钟不会影响最小重试延迟。 例如,如果当前时间为下午 2:00,BITS 将在下午 2:10 重试作业,则移动系统时钟向前 10 分钟或更多分钟并不意味着 BITS 会提前重试作业 -BITS 仍将在 10 分钟内重试作业。 若要反映 BITS 中的系统时钟更改,必须重新启动计算机或 BITS 服务。

要求

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

另请参阅

IBackgroundCopyJob::GetMinimumRetryDelay

IBackgroundCopyJob::GetNoProgressTimeout

IBackgroundCopyJob::SetNoProgressTimeout