IBackgroundCopyJob::SetNoProgressTimeout 方法 (bits.h)

設定 BITS 嘗試在發生暫時性錯誤狀況之後傳輸檔案的時間長度。 如果有進度,則會重設定時器。

語法

HRESULT SetNoProgressTimeout(
  [in] ULONG Seconds
);

參數

[in] Seconds

BITS 會在發生第一個暫時性錯誤之後嘗試傳輸檔案的時間長度,以秒為單位。 默認重試期間為 1,209,600 秒, (14 天) 。 將重試期間設定為 0 以防止重試,並強制作業進入所有錯誤的BG_JOB_STATE_ERROR狀態。 如果重試期間值超過 JobInactivityTimeout 群組原則 值 (90 天的預設) ,則 BITS 會在超過原則值之後取消作業。

傳回值

這個方法會傳回下列 HRESULT 值,以及其他值。

傳回碼 Description
S_OK
已成功設定重試期間。
BG_E_INVALID_STATE
無法BG_JOB_STATE_CANCELLED或BG_JOB_STATE_ACKNOWLEDGED作業的狀態。

備註

如果 BITS 未在重試期間進行,則會將作業的狀態從BG_JOB_STATE_TRANSIENT_ERROR移至BG_JOB_STATE_ERROR。 如果您要求錯誤通知,BITS 接著會呼叫 JobError 回 呼。

注意 變更系統時鐘不會影響重試期間。 例如,如果重試期間在14天內到期,將系統時鐘向前移動14天或更多天並不表示重試期間提早到期,重試期間仍會在14天內到期。 若要反映 BITS 中的系統時鐘變更,您必須重新啟動電腦或 BITS 服務。

規格需求

需求
最低支援的用戶端 Windows XP
最低支援的伺服器 Windows Server 2003
目標平台 Windows
標頭 bits.h
程式庫 Bits.lib
Dll QmgrPrxy.dll

另請參閱

IBackgroundCopyJob::GetNoProgressTimeout

IBackgroundCopyJob::SetMinimumRetryDelay