1<html>
2<head>
3<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
4<meta http-equiv="Content-Style-Type" content="text/css">
5<title>TCL_SearchNextPicturePath</title>
6<link rel="stylesheet" href="../css/nitro.css" type="text/css">
7</head>
8<body>
9<h1 align="left">TCL_SearchNextPicturePath <img src="../image/TWL.gif" align="middle"></h1>
10
11<h2>Definition</h2>
12<dl>
13	<dd>
14	<code>#include &lt;twl/tcl.h&gt;</code><br/> <br/>
15	<pre><code>
16TCLResult TCL_SearchNextPicturePath( const TCLAccessor* pAccessor ,
17                                     char* path ,
18                                     size_t len ,
19                                     TCLSearchObject* pSearchObj );
20	</code></pre>
21</dl>
22
23<h2>Arguments</h2>
24<p>
25<table>
26<tr><td>pAccessor<td><a href="TCLAccessor.html">Accessor</a>
27<tr><td>path<td>Buffer that stores the path
28<tr><td>len<td>Path length
29<tr><td>pSearchObj<td><a href="TCLSearchObject.html">Search object</a>
30</table>
31</p>
32
33<h2>Return Values</h2>
34<p><a href="TCLResult.html">Processing result</a></p>
35
36<h2>Description</h2>
37<p>Each call to this function gets the storage path to the next photo that completely matches the search conditions specified by the search object.</p>
38<p>If no next photo matches the search conditions, <code>TCL_RESULT_ERROR_NO_FIND_PICTURE</code> is returned.</p>
39<p>If the returned value is not <code>TCL_RESULT_SUCCESS</code>, the path value is undefined.</p>
40<p>Behavior is undefined if a function such as <a href="TCL_EncodeAndWritePicture.html"><code>TCL_EncodeAndWritePicture</code></a>, <a href="TCL_SortTable.html"><code>TCL_SortTable</code></a>, or <a href="TCL_DeletePicture.html"><CODE>TCL_DeletePicture</CODE></a> changes the number or order of photos being managed during a search.</p>
41<p>The accessor must be initialized by the <a href="TCL_LoadTable.html"><code>TCL_LoadTable</code></a> or <a href="TCL_CreateTable.html"><code>TCL_CreateTable</code></a> function.</p>
42
43<h2>See Also</h2>
44<p><code><a href="TCL_InitSearchObject.html">TCL_InitSearchObject</a></code></p>
45
46<h2>Revision History</h2>
47<p>
482009/03/23 Added a condition when behavior would be undefined.<br> 2009/03/04 Fixed typos.<br/> 2008/10/07 Initial version.
49</p>
50
51<hr><p>CONFIDENTIAL</p></body>
52</html>
53