FUNCTION_BLOCK DirList EXTENDS CBM.ETrig
This function reads directory entries. 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 ”ERROR.NO_MORE_ENTRIES” is generated and the entries in the structure ”deDirEntry” are deleted.
|
InOut:
|
|
Scope
|
Name
|
Type
|
Comment
|
Inherited from
|
|
Input
|
xExecute
|
BOOL
|
Rising edge: Action starts
Falling edge: Resets outputs
If a falling edge occurs before the function block has completed its action, the outputs operate in the usual manner and are only reset if either the action is completed or in the event of an error. In this case, the corresponding output values (xDone, xError) are present at the outputs for exactly one cycle.
|
ETrig
|
|
Output
|
xDone
|
BOOL
|
TRUE: Action successfully completed
|
ETrig
|
|
xBusy
|
BOOL
|
TRUE: Function block active
|
ETrig
|
|
xError
|
BOOL
|
TRUE: Error occurred, function block aborts action
FALSE: No error
|
ETrig
|
|
Input
|
hDir
|
CAA.HANDLE
|
Directory handle
|
|
|
Output
|
eError
|
ERROR
|
Local library error ID (5106 - FILE_NO_MORE_ENTRIES: no further entries available)
|
|
|
deDirEntry
|
FILE_DIR_ENTRY
|
Directory entry
|
|
|