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 値と他の値を返します。

リターン コード 説明
S_OK
 再試行の遅延が正常に設定されました。
BG_E_INVALID_STATE
 ジョブの状態をBG_JOB_STATE_CANCELLEDまたはBG_JOB_STATE_ACKNOWLEDGEDすることはできません。

注釈

最小再試行期間が経過する前にジョブを開始するには、 IBackgroundCopyJob::Resume メソッドを呼び出します。

ネットワークの切断またはディスク ロック エラー (chkdsk が実行されているなど) が発生した場合、または MaxInternetBandwidth グループ ポリシーが 0 の場合、BITS はジョブを再試行しません。

メモ システム クロックを変更しても、再試行の最小遅延には影響しません。 たとえば、現在の時刻が午後 2 時 00 分で、BITS が午後 2 時 10 分にジョブを再試行する場合、システム クロックを 10 分以上進めても、BITS はジョブを早期に再試行するわけではありません。BITS は 10 分でジョブを再試行します。 BITS のシステム クロックの変更を反映するには、コンピューターまたは BITS サービスを再起動する必要があります。

要件

要件 値
サポートされている最小のクライアント Windows XP
サポートされている最小のサーバー Windows Server 2003
対象プラットフォーム Windows
ヘッダー bits.h
Library Bits.lib
[DLL] QmgrPrxy.dll

こちらもご覧ください

IBackgroundCopyJob::GetMinimumRetryDelay

IBackgroundCopyJob::GetNoProgressTimeout

IBackgroundCopyJob::SetNoProgressTimeout