SysDirOpen (FUN)
FUNCTION SysDirOpen : RTS_IEC_HANDLE
Opens a specified directory and returns a handle and the first directory entry.
szDirEntry is expected to provide enough space to write the direcory entry to.
In case szDirEntry is 0, the first directory entry may be retrieved with SysDirRead.
- InOut:
Scope
Name
Type
Comment
Return
SysDirOpenRTS_IEC_HANDLEReturns the runtime system error code (see CmpErrors.library)
Input
szDirREFERENCE TO STRING
Name of directory.
Note
Empty string (‘’) is the request for the current working directory.
szDirEntryREFERENCE TO STRING
OUT_PARAMETER, optional: Directory entry as string, may be 0
diMaxDirEntryDINTOUT_PARAMETER, optional: Max number of bytes to write in pszDirEntry
pDirInfoPOINTER TO DirInfo
OUT_PARAMETER, optional: Directory information, may be 0
pResultPOINTER TO RTS_IEC_RESULT
OUT_PARAMETER: Pointer to runtime system error code (see CmpErrors.library)