Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-67
FILE_GETINFOLIST_ Procedure
Parameters
error returned value
INT
is a file-system error number indicating the outcome of the operation.
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.”
item-list input
INT .EXT:ref.*
is an array of values that specify the items of information to be returned by the
procedure. Each element of the array must be of type INT and contain a code
from Table 5-4
, later in this subsection.
number-of-items input
INT:value
specifies the number of items supplied in
item-list.
result output
INT .EXT:ref:*
is the buffer in which the requested items of information are returned. The item
values are returned in the order specified in
item-list. Each item begins on an
INT boundary. Every variable-length item has an associated item giving its length;
the caller should put this associated item into
item-list immediately before the
variable length item.
result-max input
INT:value
specifies the maximum size in bytes of the array of values that can be returned in
result. If the specified size is not large enough to hold the requested items, an
error value of 563 (buffer too small) is returned.