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 値と他の値を返します。
| リターン コード | 説明 |
|---|---|
|
再試行の遅延が正常に設定されました。 |
|
ジョブの状態を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