Sets the file pointer at a specified position.

bool AIT_FileSetPos  (
  integer nFileHandle,     // File handle
  integer nSetPos          // New file pointer position
);

nFileHandle (input)

Specify a file handle.

nSetPos (input)

Specify a new file pointer position.

The return value is true if the function was executed normally, and false if not. If the function has returned false, you can use AIT_GetLastError to acquire an extended error code. The following gives the error codes that AIT_GetLastError may return.

Extended error number	Error code
5	ERROR_ACCESS_DENIED
6	ERROR_INVALID_HANDLE
8	ERROR_NOT_ENOUGH_MEMORY
14	ERROR_OUTOFMEMORY
19	ERROR_WRITE_PROTECT
21	ERROR_NOT_READY
32	ERROR_SHARING_VIOLATION
33	ERROR_LOCK_VIOLATION
38	ERROR_HANDLE_EOF
87	ERROR_INVALID_PARAMETER
112	ERROR_DISK_FULL
148	ERROR_PATH_BUSY
1231	ERROR_NETWORK_UNREACHABLE
1392	ERROR_FILE_CORRUPT

You must not use the file pointer indicated by the nFileHandle parameter value for duplicate reading or writing operations.

If you execute this function with the new file pointer position set at 0, the current file pointer position will be held.