IBackgroundCopyFile3::SetValidationState 메서드(bits3_0.h)

  • 아티클

이 파일의 유효성 검사 상태를 설정합니다.

구문

HRESULT SetValidationState(
  [in] BOOL state
);

매개 변수

[in] state

파일 콘텐츠가 유효하면 TRUE 로 설정하고, 그렇지 않으면 FALSE로 설정합니다.

반환 값

메서드는 다음 반환 값을 반환합니다.

반환 코드 Description
S_OK
 Success
E_PENDING
 다운로드가 완료될 때까지 파일의 유효성을 검사할 수 없습니다.
BG_E_RECORD_DELETED
 이 파일과 연결된 캐시된 레코드가 삭제되었습니다.

설명

유효성 검사 상태를 FALSE 로 설정하고 원본 서버에서 파일을 다운로드한 경우 작업은 오류 코드가 BG_E_VALIDATION_FAILED 오류 상태로 이동하고 파일 진행률이 0으로 설정됩니다. 그런 다음 IBackgroundCopyJob::Resume 메서드를 호출하여 파일을 다시 다운로드할 수 있습니다.

BITS 3.0: IBackgroundCopyJob::Resume 메서드를 호출하여 파일을 다시 다운로드하지 마세요. 대신 IBackgroundCopyJob::Complete 또는 IBackgroundCopyJob::Cancel 메서드를 호출하여 현재 작업을 정리한 다음 새 작업을 만들어 파일을 다운로드합니다.

유효성 검사 상태를 FALSE 로 설정하고 파일을 피어에서 다운로드한 경우 BITS는 캐시에서 파일을 제거하고 파일 진행률을 0으로 다시 설정하고 원본 서버에서 파일을 다시 다운로드합니다.

BITS가 파일 전송을 완료한 후에만 이 메서드를 호출할 수 있습니다. 전송이 완료되면 알림을 받으려면 IBackgroundCopyCallback2::FileTransferred 메서드를 구현합니다.

IBackgroundCopyJob::Complete 메서드를 호출하면 파일의 유효성이 암시적으로 검사됩니다.

캐시에서 파일의 유효성을 검사한 다음 IBackgroundCopyJob4::SetPeerCachingFlags를 호출하여 캐싱을 사용하지 않도록 설정하는 경우(또는 피어 캐싱이 그룹 정책 통해 사용하지 않도록 설정됨) 파일은 캐시에 남아 있습니다. 파일의 유효성을 검사하기 전에 캐싱을 사용하지 않도록 설정하면 BITS는 캐시에서 파일을 제거합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista
지원되는 최소 서버 Windows Server 2008
대상 플랫폼 Windows
헤더 bits3_0.h(Bits.h 포함)
라이브러리 Bits.lib

추가 정보

IBackgroundCopyFile3

IBackgroundCopyFile3::GetValidationState

IBitsPeerCacheRecord::IsFileValidated