SysFileOpen (FUN)¶

FUNCTION SysFileOpen : RTS_IEC_HANDLE

Open or create file. A standard path will be added to the filename, if no path is specified in the file name.

If a file extension is specified in the settings, this path will be used (see category settings).

Note

File name can contain an absolute or relative path to the file. Path entries must be separated with a Slash (/) and not with a Backslash (\)!

InOut:

Scope	Name	Type	Comment
Return	`SysFileOpen`	`RTS_IEC_HANDLE`	Handle to the file or RTS_INVALID_HANDLE if failed
Input	`szFile`	STRING	File name. File name can contain an absolute or relative path to the file. Path entries must be separated with a Slash (/) and not with a Backslash (\)!
	`am`	ACCESS_MODE	Requested access mode to the file. See ACCESS_MODE for details. Here find some examples: AM_READ If file does not exist, an error is returned. If the file exists, the file will be opened AM_WRITE If file does not exist, a new file will be created. If the file exists, it will be overwritten! AM_APPEND If the file does not exist, an error is returned. If the file exists, the file will be opened
	`pResult`	POINTER TO RTS_IEC_RESULT	Pointer to runtime system error code (see CmpErrors.library)