Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-58
FILE_GETINFO_ Procedure
Parameters
error returned value
INT
is a file-system error number indicating the outcome of the call to
FILE_GETINFO_.
filenum input
INT:value
is a number that identifies the open file of interest.
filenum was returned by
FILE_OPEN_ or OPEN when the file was originally opened.
You can also specify -1 for
filenum to obtain the last-error value resulting
from a file operation that is not associated with a file number. See
“Considerations” below.
last-error output
INT .EXT:ref:1
returns the file-system error number resulting from the last operation performed on
the specified file.
filename:maxlen output:input
STRING .EXT:ref:*, INT:value
returns the fully-qualified name under which the specified file was opened. If a
DEFINE name was supplied when opening the file,
filename is the file name, not
the DEFINE name.
maxlen gives the length in bytes of the string variable
filename.
filename-length output
INT .EXT:ref:1
is the length in bytes of the name returned in
filename.
type-info output
INT .EXT:ref:5
returns an array of INT values that contain information about the file. The
meanings of these words are:
[0] Device type
[1] Device subtype
[2:4] The meanings of these words depend on the device type. When the
device type is 3 (disk) the meanings are: