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 <nitro/fs.h> 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
