get_ranges Method

Gets the list of allocated data ranges in a file.

Syntax

def get_ranges(file_path: str) -> None: ...

Remarks

This method gets the list of allocated data ranges in the file at the specified FilePath in the share currently selected by share and populates the Range* properties with the results.

The server tracks ranges of file data in 512-byte chunks, aligned to the absolute beginning of the file; thus, the size of every range returned by this method will always be a multiple of 512. Chunks that are not currently allocated (either because no data has been written to them, or because they've been freed with clear_range) will not be returned by this method.