BG_FILE_RANGE structure (bits2_0.h)

Identifies a range of bytes to download from a file.

Syntax

typedef struct _BG_FILE_RANGE {
  UINT64 InitialOffset;
  UINT64 Length;
} BG_FILE_RANGE;

Members

InitialOffset

Zero-based offset to the beginning of the range of bytes to download from a file.

Length

The length of the range, in bytes. Do not specify a zero byte length. To indicate that the range extends to the end of the file, specify BG_LENGTH_TO_EOF.

Remarks

The range must exist in the file or BITS generates an BG_E_INVALID_RANGE error.

Requirements

Requirement Value
Minimum supported client Windows Vista, Windows XP with SP2,KB842773 on Windows Server 2003 and Windows XP
Minimum supported server Windows Server 2008, Windows Server 2003 with SP1
Header bits2_0.h (include Bits.h)

See also

IBackgroundCopyFile2::GetFileRanges

IBackgroundCopyJob3::AddFileWithRanges