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 方法。

例如，如果發生網路中斷連線或磁碟鎖定錯誤 (，BITS 不會重試作業，例如 chkdsk 正在執行) 或 MaxInternetBandwidth 群組原則 為零。

注意 變更系統時鐘不會影響最小重試延遲。 例如，如果目前的時間是下午 2：00，而 BITS 是在下午 2：10 重試作業，則將系統時鐘向前移動十分鐘或更多分鐘並不表示 BITS 會提早重試工作—BITS 仍會在十分鐘內重試作業。 若要反映 BITS 中的系統時鐘變更，您必須重新啟動電腦或 BITS 服務。

規格需求

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

另請參閱

IBackgroundCopyJob：：GetMinimumRetryDelay

IBackgroundCopyJob：：GetNoProgressTimeout

IBackgroundCopyJob：：SetNoProgressTimeout