Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-180
FILENAME_FINDNEXT_ Procedure
FILENAME_FINDNEXT_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
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.
Syntax for C Programmers
•
CEXTDECS (via 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.
•
The parameter maxlen specifies the maximum length in bytes of the character
string pointed to by
name. The actual length of name in name is returned in name-
length. These three parameters must either all be supplied or all be absent.
Syntax for TAL Programmers
Parameters
error returned value
INT
#include <cextdecs(FILENAME_FINDNEXT_)>
short FILENAME_FINDNEXT_ ( short searchid
,[ char *name ]
,[ short maxlen ]
,[ short *name-length ]
,[ short *entity-info ]
,[ __int32_t tag ] );
error := FILENAME_FINDNEXT_ ( searchid ! i
,[ name:maxlen ] ! o:i
,[ name-length ] ! o
,[ entity-info ] ! o
,[ tag ] ); ! i