Guardian Procedure Calls Reference Manual

• 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
error := FILENAME_FINDNEXT_ ( searchid ! i
,[ name:maxlen ] ! o:i
,[ name-length ] ! o
,[ entity-info ] ! o
,[ tag ] ); ! i
error := FILENAME_FINDNEXT64_ ( searchid ! i
,[ name:maxlen ] ! o:i
,[ name-length ] ! o
,[ entity-info ] ! o
,[ tag ] ); ! i
Parameters
searchid
input
INT:value
is the value that was previously returned by FILENAME_FINDSTART_ to identify the search
request.
name:maxlen
input
(for FILENAME_FINDNEXT_)STRING .EXT:ref:*, INT:value
(for FILENAME_FINDNEXT64_)STRING .EXT64:ref:*, INT:value
contains the name being returned. The level of qualification of the name is determined by the
resolve-level parameter previously supplied to FILENAME_FINDSTART_.
maxlen is the length in bytes of the string variable name.
name-length
output
(for FILENAME_FINDNEXT_)INT .EXT:ref:1
(for FILENAME_FINDNEXT64_)INT .EXT64:ref:1
is the length in bytes of the value returned in name.
entity-info
output
(for FILENAME_FINDNEXT_)INT .EXT:ref:5
(for FILENAME_FINDNEXT64_)INT .EXT64:ref:5
FILENAME_FINDNEXT[64]_ Procedures 575