This function block of the ⇘ CAA_File.library opens a directory the entries (files and sub-directories) of which should be read with the help of the function block ⇘ FILE.DirList. The return value is a handle. There may be restrictions concerning the specification of the directory name, e.g. only capital letters allowed, for different targets. The function ⇘ FILE.GetProperty shows these restrictions.
Input:
|
xExecute |
BOOL |
see: ⇘ “CAA 指南” |
|
sDirName |
CAA.FILENAME |
Directory name: No special characters, Separator for sub-directories “/”, Absolute or relative path specifications Recommendation: No empty spaces Use capital letters |
Output:
|
xDone |
BOOL |
see: ⇘ “CAA 指南” |
|
xBusy |
BOOL |
see: ⇘ “CAA 指南” |
|
xError |
BOOL |
see: ⇘ “CAA 指南” |
|
eError |
FILE.ERROR |
Error ID |
|
hDir |
CAA.HANDLE |
Handle of the directory |