_BG_FILE_RANGE structure

The BG_FILE_RANGE structure 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

   
Windows version Windows Vista, Windows XP with SP2,KB842773 on Windows Server 2003 and Windows XP Windows Server 2008, Windows Server 2003 with SP1
Header bits2_0.h (include Bits.h)

See Also

IBackgroundCopyFile2::GetFileRanges

IBackgroundCopyJob3::AddFileWithRanges