Guardian Procedure Calls Reference Manual

FILE_GETINFOLISTBYNAME_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
OSS Considerations
Example
Related Programming Manuals
Summary
The FILE_GETINFOLISTBYNAME_ procedure obtains detailed information about a file identified
by file name.
The information about a file is organized as a set of discrete items. The caller provides an input
array parameter specifying a code for each item to be reported. The values of the items are reported
in an output array parameter.
A related (and simpler to use) procedure, FILE_GETINFOBYNAME_, obtains a limited set of
information about a file identified by file name.
Syntax for C Programmers
#include <cextdecs(FILE_GETINFOLISTBYNAME_)>
short FILE_GETINFOLISTBYNAME_ ( const char *filename
,short length
,short *item-list
,short number-of-items
,short *result
,unsigned short result-max
,[ unsigned short *result-length ]
,[ short *error-item ] );
NOTE: In H06.28/J06.17 RVUs with specific SPRs and later RVUs, the CEXTDECS file uses the
unsigned short data type for result-max and result-length. (For a list of the required
H06.28/J06.17 SPRs, see SPR Requirements for Increased Enscribe Limits for the H06.28/J06.17
Release (page 31).) In earlier RVUs, CEXTDECS uses the short data type for these parameters.
Syntax for TAL Programmers
error := FILE_GETINFOLISTBYNAME_ ( filename:length ! i:i
,item-list ! i
,number-of-items ! i
,result ! o
,result-max ! i
,[ result-length ] ! o
,[ error-item ] ); ! o
FILE_GETINFOLISTBYNAME_ Procedure 429