Share via

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
라이브러리 Bits.lib
DLL QmgrPrxy.dll

추가 정보

IBackgroundCopyJob::GetNoProgressTimeout

IBackgroundCopyJob::SetMinimumRetryDelay