Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-183
FILENAME_FINDSTART_ Procedure
FILENAME_FINDSTART_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
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_ procedure to retrieve individual names.
Syntax for C Programmers
•
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
#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 ] );
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