Guardian Procedure Calls Reference Manual

FILE_SAVEPOSITION_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Summary
The FILE_SAVEPOSITION_ procedure supersedes the SAVEPOSITION Procedure (Superseded by
FILE_SAVEPOSITION_ Procedure) (page 1257) , and is used to save a disk file's current file positioning
information in anticipation of a need to return to that position. The positioning information is
returned to the file system in a call to the FILE_RESTOREPOSITION_ procedure when you want to
return to the saved position. Unlike the SAVEPOSITION procedure, this procedure can be used
with Enscribe format 2 files and OSS files greater than approximately 2 gigabytes as well as with
other files.
Syntax for C Programmers
#include <cextdecs(FILE_SAVEPOSITION_)>
short FILE_SAVEPOSITION_ ( short filenum
,short *savearea
,short savemax
,short *savesize );
Syntax for TAL Programmers
error := FILE_SAVEPOSITION_ ( filenum ! i
,savearea ! o
,savemax ! i
,savesize); ! o
Parameters
filenum
input
INT:value
is the number that identifies the open disk file.
savearea
output
INT .EXT:ref:*
is the location where the positioning information is received. The size is given by the savemax
parameter.
savemax
input
INT:value
specifies the savemax parameter size in bytes. See Considerations.
504 Guardian Procedure Calls (F)