IBackgroundCopyJob4::SetMaximumDownloadTime 方法 (bits3_0.h)
設定 BITS 將花費在作業中傳輸檔案的時間上限。
語法
HRESULT SetMaximumDownloadTime(
[in] ULONG Timeout
);
參數
[in] Timeout
BITS 將花費在作業中傳輸檔案的時間上限,以秒為單位。 預設值為 7,776,000 秒 (90 天)。
傳回值
方法會傳回下列傳回值。
傳回碼 | 描述 |
---|---|
|
Success |
備註
此值是作業可以花費在 CONNECTING 或 TRANSFERRING 狀態的最大經過時間。 在 QUEUED 或TRANSIENT_ERROR狀態所花費的時間不會計入逾時值。 如果傳輸時間超過逾時值,作業會進入嚴重錯誤狀態,並出現錯誤碼BG_E_MAXDOWNLOAD_TIMEOUT。
請注意,如果計算機在 BITS 傳輸作業的數據時睡眠,即使數據未傳輸,睡眠的時間仍會計入逾時。
呼叫 IBackgroundCopyJob::Resume 方法,會重設經過的時間。
這個方法會覆寫 MaxDownloadTime 組策略。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista |
最低支援的伺服器 | Windows Server 2008 |
目標平台 | Windows |
標頭 | bits3_0.h (包含 Bits.h) |
程式庫 | Bits.lib |