IBackgroundCopyJob4::SetMaximumDownloadTime 方法 (bits3_0.h)

设置 BITS 传输作业中的文件所花费的最长时间。

语法

HRESULT SetMaximumDownloadTime(
  [in] ULONG Timeout
);

参数

[in] Timeout

BITS 将花费在传输作业中的文件的最长时间(以秒为单位)。 默认值为 7,776,000 秒(90 天)。

返回值

方法返回以下返回值。

返回代码 说明
S_OK
成功

注解

值是作业在“正在连接”或“正在传输”状态下可以花费的最长时间。 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

另请参阅

IBackgroundCopyJob4

IBackgroundCopyJob4::GetMaximumDownloadTime