IBackgroundCopyFile6::GetFilledFileRanges 메서드(bits10_1.h)
다운로드한 파일 범위 집합을 반환합니다.
구문
HRESULT GetFilledFileRanges(
[out] DWORD *rangeCount,
[out] BG_FILE_RANGE **ranges
);
매개 변수
[out] rangeCount
범위의 요소 수입니다.
[out] ranges
다운로드된 범위를 설명하는 BG_FILE_RANGE 구조체의 배열입니다. 범위는 가능한 한 많이 병합됩니다. 범위는 오프셋별로 정렬됩니다. 완료되면 CoTaskMemFree 함수를 호출하여 범위를 해제합니다.
반환 값
메서드가 성공하면 S_OK를 반환하고, 성공하지 않으면 HRESULT 오류 코드를 반환합니다. Ranges 배열을 할당할 수 없는 경우 오류가 E_OUTOFMEMORY작업이 다운로드 작업이 아니거나 서버에서 다운로드 범위를 지원하는 기능이 손실된 경우 BG_E_RANDOM_ACCESS_NOT_SUPPORTED.
설명
getFilledFileRanges 는 BITS_JOB_PROPERTY_ON_DEMAND_MODE 작업에 대한 요구 사항을 충족하는 모든 다운로드 작업에 대해 요청할 수 있습니다.
BITS_JOB_PROPERTY_ON_DEMAND_MODE 작업에 대한 요구 사항은 전송이 다운로드 작업이어야 한다는 것입니다. 작업은 DYNAMIC 이 아니어야 하며 서버는 HTTP 또는 HTTPS 서버여야 하며 범위 지원에 대한 서버 요구 사항을 모두 충족해야 합니다. 자세한 내용은 BITS 다운로드에 대한 HTTP 요구 사항을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 10 버전 1703 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2016 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | bits10_1.h(Bits.h 포함) |
| 라이브러리 | Bits.lib |