This method is obsolete. See the Remarks section below.

Description

The Utilities.FileSeek method sets the file pointer position within a file by the Offset bytes relative to the Origin position.

Declaration

Utilities.FileSeek(Handle, Offset, Origin)

Handle	[in]	Required	Integer
Offset	[in]	Required	Integer
Origin	[in]	Required	Integer
Result	Integer

Applies To

The method is applied to the following object:

Utilities

Parameters

The method has the following parameters:

Handle

Specifies the handle of the desired file.

Offset

Specifies the file pointer position (in bytes) relative to the Origin position. If Offset is positive, FileSeek forwards the file pointer position to the specified number of bytes. If Offset is negative, the function moves the pointer by Offset bytes backward.

Origin

Specifies relative to which position the file pointer position will be set. Origin can be any of the following values:

Value	Description
0	The function positions the file pointer relative to the beginning of the file.
1	The function positions the file pointer relative to the pointer's current position.
2	The function positions the pointer relative to the end of the file.

Result Value

If the file pointer has been positioned successfully, the function returns the new pointer position. Otherwise, the function returns -1.

Remarks

This method is obsolete. It is supported for backward compatibility only. To specify the file cursor position, use the aqBinaryFile.Cursor, aqTextFile.Cursor or aqTextFile.SetPosition method.

Utilities.FileSeek Method