次の方法で共有


IBackgroundCopyJob::SetNoProgressTimeout メソッド (bits.h)

一時的なエラー状態が発生した後に BITS がファイルの転送を試みる時間を設定します。 進行状況がある場合、タイマーはリセットされます。

構文

HRESULT SetNoProgressTimeout(
  [in] ULONG Seconds
);

パラメーター

[in] Seconds

最初の一時的なエラーが発生した後に BITS がファイルの転送を試みる時間 (秒単位)。 既定の再試行期間は 1,209,600 秒 (14 日間) です。 再試行を防ぎ、すべてのエラーに対してジョブを強制的にBG_JOB_STATE_ERROR状態にするには、再試行期間を 0 に設定します。 再試行期間の値が JobInactivityTimeout グループ ポリシー値 (既定値は 90 日) を超えた場合、BITS はポリシー値を超えた後にジョブを取り消します。

戻り値

このメソッドは、次の HRESULT 値と他の値を返します。

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

注釈

再試行期間中に BITS が進行しない場合、ジョブの状態がBG_JOB_STATE_TRANSIENT_ERRORからBG_JOB_STATE_ERRORに移動します。 エラー通知を要求した場合、BITS は JobError コールバックを呼び出します。

メモ システム クロックを変更しても、再試行期間には影響しません。 たとえば、再試行期間が 14 日で期限切れになった場合、システム クロックを 14 日以上前に移動しても、再試行期間が早く期限切れになるわけではありません。再試行期間は 14 日間で期限切れになります。 BITS のシステム クロックの変更を反映するには、コンピューターまたは BITS サービスを再起動する必要があります。

要件

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

こちらもご覧ください

IBackgroundCopyJob::GetNoProgressTimeout

IBackgroundCopyJob::SetMinimumRetryDelay