Guardian Procedure Calls Reference Manual

FILENAME_FINDSTART_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Device Type Considerations
Error Handling
Example
Related Programming Manual
Summary
The FILENAME_FINDSTART_ procedure sets up a search of named entities. After specifying search
criteria to FILENAME_FINDSTART_, you call the FILENAME_FINDNEXT[64]_ procedure to retrieve
individual names.
Syntax for C Programmers
#include <cextdecs(FILENAME_FINDSTART_)>
short FILENAME_FINDSTART_ ( short *searchid
,[ const char *search-pattern ]
,[ short length ]
,[ short resolve-level ]
,[ short device-type ]
,[ short device-subtype ]
,[ short options ]
,[ const char *startname ]
,[ short length ] );
• The character-string parameters search-pattern and startname are each followed by
a parameter length that specifies the length in bytes of the character string. In each case,
the character-string parameter and the corresponding length parameter must either both be
supplied or both be absent.
Syntax for TAL Programmers
error := FILENAME_FINDSTART_ ( searchid ! o
,[ search-pattern:length ] ! i:i
,[ resolve-level ] ! i
,[ device-type ] ! i
,[ device-subtype ] ! i
,[ options ] ! i
,[ startname:length ] ); ! i:i
Parameters
searchid
output
INT .EXT:ref:1
returns a value that identifies the search request for other file-name inquiry procedures.
578 Guardian Procedure Calls (F)