Guardian Procedure Calls Reference Manual

FILE_SETLASTERROR_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Summary
The FILE_SETLASTERROR_ procedure is used to set the error information for a file identified by the
file number. This procedure can be used to set the Enscribe file-system error values: last-error,
last-error detail, partition, and key in error.
Syntax for C Programmers
#include <cextdecs(FILE_SETLASTERROR_)>
short FILE_SETLASTERROR_ ( short filenum
,short errorcode
,[ short errpart ]
,[ short errkey ]
,[ short errdetail ] );
Syntax for TAL Programmers
error := FILE_SETLASTERROR_ ( filenum ! i
,errorcode ! i
,[ errpart ] ! i
,[ errkey ] ! i
,[ errdetail ] ); ! i
Parameters
filenum
input
INT:value
is a number that identifies the open file. filenum was returned by FILE_OPEN_ or OPEN
when the file was originally opened
You can also specify -1 for filenum to set the last-error value for a file that is not associated
with a file number. See Considerations.
errorcode
input
INT:value
sets the value of last-error.
Last-error indicates the file-system error code resulting from the last operation performed on the
specified file. See Considerations.
errpart
input
INT:value
is the number of the partition associated with the error for partitioned files.
FILE_SETLASTERROR_ Procedure 509