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

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

構文

HRESULT SetMaximumDownloadTime(
  [in] ULONG Timeout
);

パラメーター

[in] Timeout

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

戻り値

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

リターン コード 説明
S_OK
Success

注釈

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

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

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

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

要件

要件
サポートされている最小のクライアント Windows Vista
サポートされている最小のサーバー Windows Server 2008
対象プラットフォーム Windows
ヘッダー bits3_0.h (Bits.h を含む)
Library Bits.lib

こちらもご覧ください

IBackgroundCopyJob4

IBackgroundCopyJob4::GetMaximumDownloadTime