AIT_FileSetPos
- Organization of this page
Description
Sets the file pointer at a specified position.
Format
bool AIT_FileSetPos ( integer nFileHandle, // File handle integer nSetPos // New file pointer position );
Parameters
nFileHandle (input)
Specify a file handle.
nSetPos (input)
Specify a new file pointer position.
Return values
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 might 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 |
Notes
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.