Guardian Procedure Calls Reference Manual

errkey
input
INT:value
specifies the key associated with the error for files with alternate keys.
errdetail
input
INT:value
sets the value of the last-error detail. Last-error detail indicates additional information, if
available, for interpreting the errorcode. This value might be a file-system error number or
another kind of value, depending on the operation and the primary error.
Returned Value
INT
A file-system error code that indicates the outcome of the call.
Considerations
• You can set the last-error, last-error detail, partition in error and key in error for a file that is
not associated with a file number by specifying a filenum value of -1 to FILE_SETLASTERROR_.
• The parameters errpart, errkey and errdetail are set to a default value of 0, if the
user does not pass these parameters.
• If the filenum is not corresponding to a valid open file, the FENOTOPEN (16) error is
returned.
• The FEBADPARMVALUE (590) error is returned if the user passes a value greater than 0 to
any of errorpart, errkey or errdetail when the errorcode passed is FEOK (0).
• When FILE_SETLASTERROR_ is invoked, the file system remembers that the error values for
that file have been overridden by this procedure.
• The values that were overridden can be obtained by calling FILE_GETINFOLIST_ with an item
-code of info_ErrorExternallySet_. The file system remembers the values that were
overridden when the FILE_SETLASTERROR_ was last called. The file-system error values for
the file might have been set many times since then. For more information, see the
FILE_GETINFOLIST_ Procedure (page 411).
510 Guardian Procedure Calls (F)