1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html xmlns="http://www.w3.org/1999/xhtml">
3<head>
4<meta http-equiv="Content-Type" content="text/html; charset=windows-1252" />
5<meta http-equiv="Content-Style-Type" content="text/css" />
6<title>FS_SetCurrentDirectory</title>
7<link rel="stylesheet" href="../../css/nitro.css" type="text/css" />
8</head>
9<body>
10
11<h1>FS_SetCurrentDirectory <img src="../../image/NTR.gif"align="middle"><img src="../../image/TWL.gif" align="middle"></h1>
12<h2>Syntax</h2>
13
14<pre><code>
15#include &lt;nitro/fs.h&gt;
16
17BOOL FS_SetCurrentDirectory(const char *path);
18</code></pre>
19
20<h2>Arguments</h2>
21<table style="width:100%">
22<tbody>
23<tr>
24<td style="width:13%"><em><strong>path</strong></em></td>
25<td style="width:87%">Path that specifies the current directory.</td>
26</tr>
27</tbody>
28</table>
29
30<h2>Return Values</h2>
31<p>Returns TRUE if the current directory was set properly; FALSE otherwise. In case of failure, use <code><a href="../file/FS_GetResultCode.html">FS_GetResultCode()</a></code> to get the error details.</p>
32
33<h2>Description</h2>
34<p>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.
35</p>
36<p>This function returns <CODE>TRUE</CODE> if the archive exists, even if the specified directory does not currently exist.</p>
37
38<h2>Note</h2>
39<ul>
40<li>This function cannot be called from the interrupt handler (IRQ mode). Also, in some cases processing may not end if interrupts are left prohibited.</li>
41</ul>
42
43<h2>See Also</h2>
44<p><code><a href="../file/FS_OpenFileEx.html">FS_OpenFileEx</a> <a href="../directory/FS_OpenDirectory.html">FS_OpenDirectory</a> <a href="../directory/FS_CreateFile.html">FS_CreateFile</a> <a href="../directory/FS_DeleteFile.html">FS_DeleteFile</a> <a href="../directory/FS_RenameFile.html">FS_RenameFile</a> <a href="../directory/FS_CreateDirectory.html">FS_CreateDirectory</a> <a href="../directory/FS_DeleteDirectory.html">FS_DeleteDirectory</a> <a href="../directory/FS_RenameDirectory.html">FS_RenameDirectory</a></code></p>
45
46<h2>Revision History</h2>
47<p>
482008/09/08 Explained that directories that do not exist can be specified. <br />2007/11/01 Fixed a typo in the arguments. <br />2007/09/18 Initial version.<br />
49</p>
50<hr><p>CONFIDENTIAL</p></body>
51</html>
52