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 http-equiv="Content-Style-Type" content="text/css">
7<LINK rel="stylesheet" type="text/css" href="../CSS/revolution.css">
8<title>VFFileSearchNext(W)</title>
9</head>
10
11<body>
12
13<h1>VFFileSearchNext(W)</h1>
14
15<h2>C Specification</h2>
16<dl><dd><pre><code>
17#include &lt;revolution/vf.h&gt;
18
19typedef s32	VFErr;
20
21VFErr VFFileSearchNext( VFDta* dta );
22VFErr VFFileSearchNextW( VFWDta* dta );
23</code></pre></dd></dl>
24
25<h2>Arguments</h2>
26<p>
27<TABLE border="1" >
28  <tr>
29<TD valign="top" width="120" bgcolor="#ffffe8"><CODE><STRONG><EM>dta</EM></STRONG></CODE></TD>
30<TD width="520">The address storing the file search information.</TD>
31  </tr>
32</TABLE>
33</p>
34
35<h2>Return Values</h2>
36<PRE>
37Returns 0 when successful
38Otherwise, returns <code><a href="./VFErr.html">VFErr</a></code> other than 0
39</PRE>
40
41
42<H2>Description</H2>
43<p>
44This function performs the next file search in conjunction with the specified file search information.<BR><BR>The file search information obtained with <code><a href="./VFFileSearchFirst.html">VFFileSearchFirst</a></code> is specified for <CODE>dta</CODE>.<br>As a result, <code>VFFileSearchFirst</code> must be issued before <code>VFFileSearchNext</code>.<BR>When a file matching the search conditions is found, that results is stored in <CODE>dta</CODE>.<br>The <CODE>longName</CODE> is stored as a search result when the file name exceeds the 8.3 letters convention or when the file name fits the format but is all lowercase. In this case, the short file name is stored in <CODE>fileName</CODE>.<BR><br>Because the  information obtained and specified in <CODE>dta</CODE> is needed when issuing <CODE>VFFileSearchNext</CODE>, do not destroy the buffer when re-using <CODE>VFFileSearchNext</CODE>. <br>The <code><a href="./VFDta.html">VFDta</a></code> structure is a region used for VF internal processes. Operations cannot be guaranteed if <CODE>VFDta</CODE> has been edited.<BR>
45</p>
46
47<h2>See Also</h2>
48<p>
49<code><a href="./VFFileSearchFirst.html">VFFileSearchFirst</a></code>, <code><a href="./VFDta.html">VFDta</a></code>
50</p>
51
52<H2>Revision History</H2>
53<p>
542006/05/31<br>2007/05/08 Revised Description.fc
55</p>
56
57
58<hr><p>CONFIDENTIAL</p></body>
59</html>
60