IBackgroundCopyCallback3::FileRangesTransferred 메서드(bits10_1.h)

BITS는 하나 이상의 파일 범위를 다운로드한 경우 FileRangesTransferred 메서드의 구현을 호출합니다. 파일 범위는 IBackgroundCopyFile6::RequestFileRanges 메서드를 사용하여 작업에 추가됩니다.

구문

HRESULT FileRangesTransferred(
  IBackgroundCopyJob     *job,
  IBackgroundCopyFile    *file,
  DWORD                  rangeCount,
  const BG_FILE_RANGE [] ranges
);

매개 변수

job

작업의 속성, 진행률 및 상태 정보에 액세스하는 메서드를 포함하는 IBackgroundCopyJob 개체입니다. pJob을 해제하지 마세요. BITS는 메서드가 반환될 때 인터페이스를 해제합니다.

file

범위가 변경된 파일에 대한 정보를 포함하는 IBackgroundCopyFile 개체입니다. pFile을 해제하지 마세요. BITS는 메서드가 반환될 때 인터페이스를 해제합니다.

rangeCount

범위 배열의 항목 수입니다.

ranges

FileRangesTransferred에 대한 마지막 호출 또는 IBackgroundCopyFile6::RequestFileRanges 메서드에 대한 마지막 호출 이후 전송된 파일 범위의 배열입니다. 범위를 해제하지 마세요 . BITS는 FileRangesTransferred 메서드가 반환될 때 범위 메모리를 해제합니다.

반환 값

이 메서드는 성공에 대한 S_OK 반환합니다. 그렇지 않으면 오류 코드를 반환합니다.

설명

이 메서드에서 반환된 범위가 요청한 범위와 일치하지 않을 수 있습니다. 이는 BITS가 동일한 바이트 범위를 두 번 다운로드하지 않고 범위의 일부가 다운로드될 때 BITS가 보고할 수 있기 때문입니다.

구현은 최대 리소스 부하 조건에서 모든 수정 이벤트를 수신할 수 없습니다.

BITS는 대량의 이벤트를 생성합니다. 상태 및 진행률 정보에 대한 타이머 및 폴링을 만들거나 이 콜백 사용을 제한하는 것이 좋습니다. 이 콜백을 사용하는 경우 구현을 짧게 유지합니다. BITS_JOB_PROPERTY_MINIMUM_NOTIFICATION_INTERVAL 속성을 요구 사항을 충족하는 가장 높은 값으로 설정해야 합니다. 이렇게 하면 불필요한 콜백 수가 줄어듭니다.

참고 BITS는 사용자당 최대 4개의 동시 알림을 지원합니다. 하나 이상의 애플리케이션이 사용자가 반환하지 못하도록 4개의 알림을 모두 차단하는 경우 하나 이상의 차단 알림이 반환될 때까지 동일한 사용자로 실행되는 애플리케이션은 알림을 받지 않습니다.

 

예제

이 함수를 사용하는 방법에 대한 예제는 IBackgroundCopyCallback3 인터페이스의 예제 코드를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10, 버전 1703 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2016 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	bits10_1.h(Bits.h 포함)
라이브러리	Bits.lib

추가 정보

IBackgroundCopyCallback3