IBackgroundCopyJob::SetMinimumRetryDelay 方法 (bits.h)

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

语法

HRESULT SetMinimumRetryDelay(
  [in] ULONG Seconds
);

参数

[in] Seconds

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

返回值

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

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

注解

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

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

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

要求

要求
最低受支持的客户端 Windows XP
最低受支持的服务器 Windows Server 2003
目标平台 Windows
标头 bits.h
Library Bits.lib
DLL QmgrPrxy.dll

另请参阅

IBackgroundCopyJob::GetMinimumRetryDelay

IBackgroundCopyJob::GetNoProgressTimeout

IBackgroundCopyJob::SetNoProgressTimeout