FILE.DirList (FB: Prefix fildls)

FILE.DirList (FB; Prefix fildls)

This function of the CAA_File.library reads directory or file properties. The function block needs a valid handle which identifies the directory as a transfer parameter. The information is written to structure ”deDirEntry” of type ”FILE.DIR_ENTRY”. If the function block cannot find any further entries the error message ”FILE.NO_MORE_ENTRIES” is generated and the entries in the structure ”deDirEntry” are deleted.

Input:

xExecute	BOOL	see: CAA Guidelines
hDir	CAA.HANDLE	Handle of the directory

Output:

xDone	BOOL	see: CAA Guidelines
xBusy	BOOL	see: CAA Guidelines
xError	BOOL	see: CAA Guidelines
eError	FILE.ERROR	Error ID 5106 - FILE.NO_MORE_ENTRIES: no further entries available
deDirEntry	FILE.DIR_ENTRY	Information on directory or file