共用方式為


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 值及其他值。

回傳碼 Description
S_OK
重試延遲已成功設定。
BG_E_INVALID_STATE
工作狀態無法BG_JOB_STATE_CANCELLED或BG_JOB_STATE_ACKNOWLEDGED。

備註

若想在最低重試期限結束前開始工作,請呼叫 IBackgroundCopyJob::Resume 方法。

若發生網路斷線或磁碟鎖定錯誤(例如,chkdsk 正在執行)或 MaxInternetBandwidth 群組政策為零,BITS 不會重試該工作。

便條 更改系統時鐘不會影響最小重試延遲。 例如,如果目前時間是下午2點,而BITS要在下午2點10分重試該工作,將系統時鐘往前撥十分鐘或更久並不代表BITS會提前重試——BITS仍會在十分鐘內重試該工作。 為了反映 BITS 系統時鐘的變動,您必須重新啟動電腦或 BITS 服務。

需求

Requirement 價值觀
最低支援的用戶端 視窗XP
支援的最低伺服器 Windows Server 2003
目標平臺 窗戶
Header Bits.h
Library Bits.lib
DLL QmgrPrxy.dll

另請參閱

IBackgroundCopyJob::GetMinimumRetryDelay

IBackgroundCopyJob::GetNoProgressTimeout

IBackgroundCopyJob::SetNoProgressTimeout