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_FindDir</title> 9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css"> 10</head> 11 12<body> 13 14<h1 align="left">FS_FindDir<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_FindDir( FSFile *p_dir, const char *path );</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 <code><a href="../fs_file_type.html">FSFile</a></code> structure.</TD> 28 </TR> 29 <TR> 30<TD width="13%"><EM><STRONG>path</STRONG></EM></TD> 31<TD width="87%">Directory's path name</TD> 32 </TR> 33 </TBODY> 34</TABLE> 35 36<h2>Return Values</h2> 37<p>If the directory list is correctly opened it returns TRUE. Otherwise it returns FALSE.</p> 38 39<H2>Description</H2> 40<P>This function opens a directory list using a specified path name. For more information on path name formatting, see the description of the <CODE>FS_OpenFileEx</CODE> function. If you call the <CODE>FS_ReadDir</CODE> function using the directory list that was opened, you will be able to sequentially list the file entries in the directory as an <CODE>FSDirEntry</CODE> structure. <BR> 41</P> 42<H2>Note</H2> 43<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> 44<BR> 45<h2>See Also</h2> 46<p><CODE><A href="../fs_file_type.html">FSFile</A> <BR><A href="../fs_dir_entry_type.html">FSDirEntry</A><BR> <A href="FS_ReadDir.html">FS_ReadDir</A><BR> <A href="FS_TellDir.html">FS_TellDir</A> <BR><A href="FS_SeekDir.html">FS_SeekDir</A><BR> <A href="FS_RewindDir.html">FS_RewindDir</A><BR> <A href="FS_OpenFileEx.html">FS_OpenFileEx</A><BR> <A href="../fs_file_name_max_const.html">FS_FILE_NAME_MAX</A></CODE></p> 47 48<H2>Revision History</H2> 49<P> 502008/10/02 Updated the See Also list.<BR>2004/09/24 Added the description in the Caution section regarding the conditions for calling this function.<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> 51</P> 52<hr><p>CONFIDENTIAL</p></body> 53</html> 54
