IBackgroundCopyJob4::SetMaximumDownloadTime メソッド (bits3_0.h)

BITS がジョブ内のファイルの転送に費やす最大時間を設定します。

構文

HRESULT SetMaximumDownloadTime(
  [in] ULONG Timeout
);

パラメーター

[in] Timeout

BITS がジョブ内のファイルの転送に費やす最大時間 (秒単位)。 既定は 7,776,000 秒 (90 日) です。

戻り値

メソッドは、次の戻り値を返します。

注釈

この値は、ジョブが CONNECTING 状態または TRANSFERRING 状態で費やすことができる最大経過時間です。 QUEUED または TRANSIENT_ERROR 状態で費やされた時間は、タイムアウト値に対してカウントされません。 転送時間がタイムアウト値を超えた場合、ジョブは致命的なエラー状態にBG_E_MAXDOWNLOAD_TIMEOUTエラー コードを入力します。

BITS がジョブのデータを転送している間にコンピューターがスリープ状態になった場合、データが転送されていない場合でも、スリープにかかった時間はタイムアウトに対してカウントされることに注意してください。

IBackgroundCopyJob::Resume メソッドを呼び出すと、経過時間がリセットされます。

このメソッドは、MaxDownloadTime グループ ポリシーをオーバーライドします。

要件

こちらもご覧ください

IBackgroundCopyJob4

IBackgroundCopyJob4::GetMaximumDownloadTime