FS_SetCurrentDirectory

Syntax

#include <nitro/fs.h>

BOOL FS_SetCurrentDirectory(const char *path);

Arguments

Return Values

Returns TRUE if the current directory was set properly; FALSE otherwise. In case of failure, use FS_GetResultCode() to get the error details.

Description

Sets the current directory. The system will reference the current directory that was specified with this function when a relative path is specified in calls to FS library functions.

This function returns TRUE if the archive exists, even if the specified directory does not currently exist.

Note

• This function cannot be called from the interrupt handler (IRQ mode). Also, in some cases processing may not end if interrupts are left prohibited.

See Also

FS_OpenFileEx FS_OpenDirectory FS_CreateFile FS_DeleteFile FS_RenameFile FS_CreateDirectory FS_DeleteDirectory FS_RenameDirectory

Revision History

2008/09/08 Explained that directories that do not exist can be specified.
2007/11/01 Fixed a typo in the arguments.
2007/09/18 Initial version.

CONFIDENTIAL