다음을 통해 공유

IBackgroundCopyFile6::RequestFileRanges 메서드(bits10_1.h)

  • 아티클

다운로드 우선 순위를 지정하는 새 파일 범위 집합을 추가합니다.

구문

HRESULT RequestFileRanges(
  [in] DWORD                  rangeCount,
  [in] const BG_FILE_RANGE [] ranges
);

매개 변수

[in] rangeCount

Ranges 배열의 크기를 지정합니다.

[in] ranges

다운로드할 파일 범위의 배열입니다. 요청된 범위는 이전에 다운로드(또는 보류 중인) 범위와 겹칠 수 있습니다. 범위는 겹치지 않는 범위로 자동으로 분할됩니다.

반환 값

메서드가 성공하면 S_OK를 반환하고, 성공하지 않으면 HRESULT 오류 코드를 반환합니다. 요청 된 범위의 일부가 실제 파일 크기를 벗어나면 BG_E_INVALID_RANGE 반환됩니다. 작업이 다운로드 작업이 아니거나 서버에서 다운로드 범위를 지원하는 기능이 손실되면 BG_E_RANDOM_ACCESS_NOT_SUPPORTED 반환됩니다.

설명

BITS_JOB_PROPERTY_ON_DEMAND_MODE 작업에 대한 요구 사항을 충족하는 모든 다운로드 작업에 대해RequestFileRanges를 요청할 수 있습니다.

BITS_JOB_PROPERTY_ON_DEMAND_MODE 작업에 대한 요구 사항은 전송이 다운로드 작업이어야 한다는 것입니다. 작업은 DYNAMIC 이 아니어야 하며 서버는 HTTP 또는 HTTPS 서버여야 하며 범위 지원에 대한 서버 요구 사항을 모두 충족해야 합니다. 자세한 내용은 BITS 다운로드에 대한 HTTP 요구 사항을 참조하세요.

요청된 범위가 모두 다운로드되면 파일의 모든 바이트가 전송된 경우 작업 상태가 BG_JOB_STATE_TRANSFERRED 설정됩니다. 그렇지 않으면 작업 상태가 BG_JOB_STATE_SUSPENDED 설정됩니다.

요구 사항

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

추가 정보

IBackgroundCopyFile6