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 值以及其他值。
返回代码 | 说明 |
---|---|
|
已成功设置重试延迟。 |
|
作业的状态不能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