IDeliveryOptimizationJob::AddFileWithRanges 메서드

다운로드 작업에 파일을 추가하고 다운로드하려는 파일의 범위를 지정합니다.

구문

HRESULT AddFileWithRanges(
  [in]           LPCWSTR       fileId,
  [in]           LPCWSTR       remoteUrl,
  [in]           LPCWSTR       localName,
  [in, optional] DWORD         rangeCount,
  [in, optional] BG_FILE_RANGE ranges[],
  [in, optional] ULONG64       fileSize
);

매개 변수

fileId [in]

게시된 콘텐츠의 고유 식별자인 Null 종료 문자열입니다. 게시되지 않은 콘텐츠의 경우 호출자가 작업 내의 파일을 식별하는 데 사용할 수 있는 고유한 문자열일 수 있습니다.

remoteUrl [in]

서버에서 파일의 이름을 포함하는 Null로 종료된 문자열입니다.

localName [in]

클라이언트에서 파일의 이름을 포함하는 Null로 종료된 문자열입니다.

rangeCount [in, optional]

범위의 요소 수입니다.

범위 [in, optional]

다운로드할 범위를 지정하는 하나 이상의 BG_FILE_RANGE 구조체 배열입니다. 중복되거나 겹치는 범위를 지정하지 마세요.

fileSize [in, optional]

파일 크기(바이트)입니다. 크기를 호출자 애플리케이션에 알 수 없는 경우 DO_UNKNOWN_FILE_SIZE 전달합니다.

반환 값

이 메서드는 다음 반환 값뿐만 아니라 다른 값을 반환합니다.

반환 코드	설명
S_OK	성공.
E_INVALIDARG	로컬 파일 이름은 NULL 또는 빈 문자열입니다.
E_ACCESSDENIED	사용자에게 클라이언트의 지정된 디렉터리에 쓸 수 있는 권한이 없습니다.
DO_E_INVALID_RANGE	범위 중 하나가 잘못되었습니다. 예를 들어 InitialOffset은 BG_LENGTH_TO_EOF 설정됩니다.
DO_E_OVERLAPPING_RANGES	중복되거나 겹치는 범위를 지정할 수 없습니다. 참고: 범위는 길이가 아닌 값의 오프셋을 기준으로 정렬됩니다. 오프셋이 같지만 역순으로 표시된 범위를 입력하면 이 오류가 반환됩니다. 예를 들어 100.5 및 100.0을 해당 순서로 입력하면 작업에 파일을 추가할 수 없습니다.
DO_E_INVALID_STATE	작업의 상태는 BG_JOB_STATE_CANCELLED 수 없거나 BG_JOB_STATE_ACKNOWLEDGED 수 없습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10 버전 1709 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server, 버전 1709 [데스크톱 앱만 해당]
헤더	Deliveryoptimization.h
IDL	DeliveryOptimization.idl
라이브러리	Dosvc.lib
DLL	Dosvc.dll
IID	IID_IDeliveryOptimizationJob EE2584CF-A69C-4848-B633-2649962B3EF7로 정의됩니다.

추가 정보

IDeliveryOptimizationJob