Guardian Procedure Calls Reference Manual

FILENAME_FINDNEXT[64]_ Procedures
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Nowait Considerations
Related Programming Manual
Summary
The FILENAME_FINDNEXT_ procedure returns the next name in a set of named entities that was
defined by a call to the FILENAME_FINDSTART_ procedure. FILENAME_FINDNEXT64_ is a 64–bit
version of the FILENAME_FINDNEXT_ procedure.
FILENAME_FINDNEXT64_ extends the capabilities of FILENAME_FINDNEXT_ in several ways:
• It permits the name, name-length, and entity-info arguments to reside outside of the
32-bit addressable range.
• It is callable from both 32-bit and 64-bit processes.
• It allows a 64-bit nowait I/O tag to be passed.
NOTE: The FILE_FINDNEXT64_ procedure is supported on systems running H06.24 and later
H-series RVUs and J06.13 and later J-series RVUs. Its use is recommended for new code.
Syntax for C Programmers
#include <cextdecs(FILENAME_FINDNEXT_)>
short FILENAME_FINDNEXT_ ( short searchid
,[ char *name ]
,[ short maxlen ]
,[ short *name-length ]
,[ short *entity-info ]
,[ __int32_t tag ] );
• CEXTDECS (through the included file TNSINTH) defines 32-bit values as the typedef
__int32_t, which for TNS and TNS/R compiles is defined as long and for TNS/E compiles
is defined as int.
#include <cextdecs(FILENAME_FINDNEXT64_)>
short FILENAME_FINDNEXT64_ ( short searchid
,[ char _ptr64 *name ]
,[ short maxlen ]
,[ short _ptr64 *name-length ]
,[ short _ptr64 *entity-info ]
,[ long long tag ] );
574 Guardian Procedure Calls (F)