Guardian Programming Reference Summary for C

Functions Summary (R-Z)
Guardian Programming Reference Summary for C—522630-001
8-11
returned value:
SAVEPOSITION
(superseded by FILE_SAVEPOSITION_) Saves a disk file’s current file-positioning
information. The information is returned to the file system in a call to REPOSITION.
_status_lt (<returned_value>) indicates resource allocation failure.
_status_eq (<returned_value>) indicates that the segment was resized
successfully; error contains 0.
_status_gt (<returned_value>) indicates that an error occurred; error
contains the error value (the specified extended
segment was unaffected).
-2 = Unable to allocate segment space.
-1 = Unable to allocate page table space.
0 = Successful call; the size of the specified extended segment has been changed to
new-segment-size.
2=The seg-id parameter specified a nonexistent extended segment or the
extended segment is of a type that may not be resized (see Considerations).
12 = The extended segment is a shared segment and cannot be reduced or the
segment is currently being resized.
21 = An invalid new-segment-size was specified.
24 = The seg-id parameter specified a privileged segment ID (greater than 2047)
and the caller was not privileged.
29 = A required parameter was not supplied.
43 = Disk space could not be allocated to accommodate the new-segment-size
specified.
45 = The existing permanent swap file for the extended segment is not large enough
to back the requested new-segment-size.
#include <cextdecs(SAVEPOSITION)>
_cc_status SAVEPOSITION ( short filenum /* i */
,short _near *positioning-block /* o */
,[ short _near *positioning-blksize ] ); /* o */
_status_lt (<returned_value>) An error occurred (call FILEINFO).
_status_eq (<returned_value>) SAVEPOSITION is successful.
_status_gt (<returned_value>) The file is not a disk file.