Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-92
FILE_GETINFOLISTBYNAME_ Procedure
Parameters
error returned value
INT
is a file-system error number indicating the outcome of the operation.
filename:length input:input
STRING .EXT:ref:*, INT:value
specifies the Guardian name of the file of interest. The value of
filename must
be exactly
length bytes long and must be a valid file name or DEFINE name. If
the name is partially qualified, it is resolved using the contents of the =_DEFAULTS
DEFINE.
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
value of 30 or greater from Table 5-4
on page 5-50 (under FILE_GETINFOLIST_ ).
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 and the contents of result are
undefined.