Crestron SIMPL+ - FindFirst Function

Crestron SIMPL+
®
Software
Language Reference Guide - DOC. 5797G SIMPL+
®
z 149
FindFirst
Name:
FindFirst
Syntax:
SIGNED_INTEGER FindFirst(STRING filespec, FILE_INFO
info)
Description:
This command searches a directory for file(s) matching the given file specification.
Always followed with a FindClose, refer to page 148.
Requires StartFileOperations(), refer to page 183.
Parameters:
FILESPEC specifies the filename to look for. It can be a full path name or a relative
path name with wildcards ( the ‘*’ character), refer to page 14.
INFO – FILE_INFO structure containing the information about a found
file:
File Attribute Bit Flags: - May be checked with bitwise and character.
Return Value:
Returns 0 if a file is found matching the specification and –1 if an error occurred.
KEYWORD ATTRIBUTE
ARDONLY File is marked read only
AHIDDEN File is hidden
ASYSTEM File is marked as a system file
AVOLUME File is a volume label
ADIRENT File is a directory
ARCHIVE File is marked as archived