MFS CHGFILEPTR: Difference between revisions
mNo edit summary |
mNo edit summary |
||
| Line 8: | Line 8: | ||
;offset:is the signed offset which depending on the type parameter is used to determine the new position within the file. | ;offset:is the signed offset which depending on the type parameter is used to determine the new position within the file. | ||
;type:indicates the basis of a seek operation. | ;type:indicates the basis of a seek operation. | ||
: | ::0 indicates seek relative to beginning of file. | ||
: | ::1 indicates seek relative to current position within the file. | ||
: | ::2 indicates seek relative to end of file. | ||
==Returns== | ==Returns== | ||
| Line 27: | Line 27: | ||
unsigned short type; | unsigned short type; | ||
</PRE> | </PRE> | ||
Revision as of 20:44, 21 May 2019
Move the file's logical read position pointer.
Syntax
int far pascal MFS_CHGFILEPTR(offset, type)
Parameters
- offset
- is the signed offset which depending on the type parameter is used to determine the new position within the file.
- type
- indicates the basis of a seek operation.
- 0 indicates seek relative to beginning of file.
- 1 indicates seek relative to current position within the file.
- 2 indicates seek relative to end of file.
Returns
- 0
- If no error is detected, a zero error code is returned.
- non-zero
- If an error is detected, a non-zero error code is returned.
Remarks
The file system may want to take the seek operation as a hint that an I/O operation is about to take place at the new position and initiate a positioning operation on sequential access media or read-ahead operation on other media.
Example Source Code
Calling Sequence
int far pascal MFS_CHGFILEPTR(offset, type) long offset; unsigned short type;