FILE_DirListΒΆ

../_images/058e6ddce38981c30a33139000eba54e
Parameter Value
Library_File_Name CAA_File.lib
Firmware V2.1
Type Type_Function_Block_History
Group Directory

FILE_DirList 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.

If FILE_DirList is called for an empty volume (e.g. just formatted), an empty file is returned which represents the volume entry of the device. Calling the function block again delivers an error return with code FILE_NO_MORE_ENTRIES.