IBackgroundCopyJob4::SetMaximumDownloadTime 方法 (bits3_0.h)
设置 BITS 传输作业中的文件所花费的最长时间。
语法
HRESULT SetMaximumDownloadTime(
[in] ULONG Timeout
);
参数
[in] Timeout
BITS 将花费在传输作业中的文件的最长时间(以秒为单位)。 默认值为 7,776,000 秒(90 天)。
返回值
方法返回以下返回值。
返回代码 | 说明 |
---|---|
|
成功 |
注解
值是作业在“正在连接”或“正在传输”状态下可以花费的最长时间。 QUEUED 或 TRANSIENT_ERROR 状态所花费的时间不计入超时值。 如果传输时间超过超时值,作业将进入错误状态,错误代码为 BG_E_MAXDOWNLOAD_TIMEOUT。
请注意,如果在 BITS 传输作业数据时计算机处于睡眠状态,即使数据未传输,睡眠所用的时间也会计入超时。
调用 IBackgroundCopyJob::Resume 方法重置运行时间。
此方法替代 MaxDownloadTime 组策略。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista |
最低受支持的服务器 | Windows Server 2008 |
目标平台 | Windows |
标头 | bits3_0.h (包括 Bits.h) |
Library | Bits.lib |