1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2<html> 3 4<head> 5<META http-equiv="Content-Type" content="text/html; charset=windows-1252"> 6<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.0.0 for Windows"> 7<META http-equiv="Content-Style-Type" content="text/css"> 8<title>FS_SeekDir</title> 9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css"> 10</head> 11 12<body> 13 14<h1 align="left">FS_SeekDir <img src="../../image/NTR.gif"align="middle"><img src="../../image/TWL.gif" align="middle"></h1> 15<h2>Syntax</h2> 16 17<dl> 18 <dd> 19<CODE>#include <nitro/fs.h></CODE><BR> <BR> <CODE>BOOL FS_SeekDir( <a href="../fs_file_type.html">FSFile</a> *p_dir, const <A href="../fs_dir_pos_type.html">FSDirPos</a> *p_pos );</CODE><br> <br> 20 </dd> 21</dl> 22<h2>Arguments</h2> 23<TABLE border="1" width="100%"> 24 <TBODY> 25 <TR> 26<TD width="13%"><EM><STRONG>p_dir</STRONG></EM></TD> 27<TD width="87%">Address of the <A href="../fs_file_type.html"><CODE>FSFile</CODE></A> structure.</TD> 28 </TR> 29 <TR> 30<TD width="13%"><EM><STRONG>p_pos</STRONG></EM></TD> 31<TD width="87%">The <A href="../fs_dir_pos_type.html">FSDirPos</a> structure in which the directory list position is stored.</TD> 32 </TR> 33 </TBODY> 34</TABLE> 35 36<h2>Return Values</h2> 37<p>Returns TRUE If the directory list position is correctly acquired; FALSE otherwise.<BR> 38</p> 39 40<H2>Description</H2> 41<P>This function acquires the directory list, including the position in the list. The value of <code><A href="../fs_dir_pos_type.html">FSDirPos</a></code> indicates the position. Use the following method to obtain it. <BR> 42<TABLE border="0"> 43 <TR> 44<TD><code><A href="FS_ReadDir.html">FS_ReadDir()</A></code></TD> 45<TD>When the <CODE>is_directory</CODE> member in the acquired <code><A href="../fs_dir_entry_type.html">FSDirEntry</A></code> structure is 1,<BR> the <CODE>dir_id</CODE> member indicates the beginning of the directory list.</TD> 46 </TR> 47 <TR> 48<TD><code><A href="FS_TellDir.html">FS_TellDir()</A></code></TD> 49<TD>When it succeeds, the directory list's current position will be stored.</TD> 50 </TR> 51</TABLE> 52<BR> 53<H2>Note</H2> 54<p><font color="#800000">This function cannot be called from the interrupt handler (IRQ mode).<br> Also note that in some cases processing may not end if interrupts are left prohibited.<br></font></p> 55<BR> 56<h2>See Also</h2> 57<p><A href="../fs_file_type.html"><code>FSFile</A><BR> <A href="../fs_dir_entry_type.html">FSDirEntry</A><BR> <A href="../fs_dir_pos_type.html">FSDirPos</A><BR> <A href="FS_FindDir.html">FS_FindDir</A><BR> <A href="FS_ReadDir.html">FS_ReadDir</A><BR> <A href="FS_TellDir.html">FS_TellDir</A><BR> <A href="FS_RewindDir.html">FS_RewindDir</code></A></p> 58 59<H2>Revision History</H2> 60<P> 612004/09/24 Added the description in the Caution section regarding the conditions for calling this function.<br> 2004/05/14 Revised description due to changes in <CODE>FSDirPos</CODE>.<BR> 2004/04/08 Revised description due to the integration of <CODE>FSDir</CODE> and <CODE>FSFile</CODE><BR> 2004/04/01 Initial version<BR> 62</P> 63<hr><p>CONFIDENTIAL</p></body> 64</html> 65
