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 속성을 요구 사항을 충족하는 가장 높은 값으로 설정해야 합니다. 이렇게 하면 불필요한 콜백 수가 줄어듭니다.
예제
이 함수를 사용하는 방법에 대한 예제는 IBackgroundCopyCallback3 인터페이스의 예제 코드를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 10, 버전 1703 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2016 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | bits10_1.h(Bits.h 포함) |
| 라이브러리 | Bits.lib |