fsDirChange (Function)

This function changes the working directory and/or the current media.

To change the media, insert the drive in the path.

Note: the change will only take effect for the calling thread. The working directory for all other threads is not changed.

Input:

path : STRING

Path of the new directory. Both absolute and relative paths are allowed.

Returns: INT

Declaration:

FUNCTION fsDirChange : INT;
VAR_INPUT
  path : STRING;
END_VAR;

Example:

INCLUDE rtcu.inc
 
PROGRAM test;
VAR
  rc : INT;
END_VAR;
 
BEGIN
  ...
  // Change directory
  rc := fsDirChange(path := "..\Docs\logs");
  IF rc = 0 THEN
     ...
  ELSE
    // Failed to change directory
     ...
  END_IF;
  ...
  // Change media
  rc := fsDirChange(path := "B:\");
  ...
END;
 
END_PROGRAM;