util_chdir2path

The util_chdir2path function changes the current directory to a specified directory where you will access a file.

When running under Windows, use a critical section to ensure that more than one thread does not call this function at the same time.

Using util_chdir2path makes file access a little quicker because this function does not require a full path.

Syntax

int util_chdir2path(char *path);

Returns

0 if the directory was changed, or -1 if the directory could not be changed.

Parameters

char *path is the name of a directory.

The parameter must be a writable string because the string is not permanently modified.