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_LoadTable</title>
6<link rel="stylesheet" href="../css/nitro.css" type="text/css">
7</head>
8<body>
9<h1 align="left">TCL_LoadTable <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_LoadTable( TCLAccessor* pAccessor ,
17                         void* tableBuffer ,
18                         u32 tableBufferSize ,
19                         void* workBuffer ,
20                         u32 workBufferSize ,
21                         FSResult* pFSResult );
22	</code></pre>
23</dl>
24
25<h2>Arguments</h2>
26<p>
27<table>
28<tr><td><CODE>pAccessor</CODE><td><a href="TCLAccessor.html">Accessor</a>
29<tr><td><code>tableBuffer</code><td>Buffer for loading the management file
30<tr><td><code>tableBufferSize</code><td>Size of the buffer for loading the management file
31<tr><td><code>workBuffer</code><td>Working buffer
32<tr><td><code>workBufferSize</code><td>Size of the working buffer
33<tr><td><CODE>pFSResult</CODE><td>Processing result when an error has been generated by an FS function inside this function
34</table>
35</p>
36
37<h2>Return Values</h2>
38<p><a href="TCLResult.html">Processing result</a></p>
39
40<h2>Description</h2>
41<p>Loads the management file.</p>
42<p>For <code>tableBuffer</code> and <code>tableBufferSize</code>, specify a buffer and a buffer size. The buffer size is determined by the <a href="TCL_GetTableBufferSize.html"><code>TCL_GetTableBufferSize</code></a> function.</p>
43<p>For <code>workBuffer</code> and <code>workBufferSize</code>, specify a buffer and a buffer size. The buffer size is determined by the <a href="TCL_GetWorkBufferSize.html"><code>TCL_GetWorkBufferSize</code></a> function. </p>
44<p>The values returned by this function are explained in the following table.
45<table>
46<tr><td><code>TCL_RESULT_SUCCESS</code><td>Loading and writing are both possible
47<tr><td><code>TCL_RESULT_ERROR_EXIST_OTHER_FILE</code><br/><code>TCL_RESULT_ERROR_ALREADY_MANAGED</code><td>Loading is possible; writing is not possible
48<tr><td><code>Other</code><td>Neither loading nor writing is possible
49</table>
50 </p>
51<p>If the process only loads photos and no write operation is needed, the process can continue even if the function returns <code>TCL_RESULT_ERROR_EXIST_OTHER_FILE</code> or <code>TCL_RESULT_ERROR_ALREADY_MANAGED</code>.</p>
52<p>If the process involves writing photos, use the <a href="TCL_RepairTable.html"><code>TCL_RepairTable</code></a> function to enable writing if either of those two errors is returned.</p>
53<p>If some other error is returned, neither loading nor writing is possible. Use the <a href="TCL_CreateTable.html"><code>TCL_CreateTable</code></a> function to regenerate the management file.</p>
54
55<h2>See Also</h2>
56<p><code><a href="TCL_RepairTable.html">TCL_RepairTable</a><BR> <a href="TCL_CreateTable.html">TCL_CreateTable</a></code></p>
57
58<h2>Revision History</h2>
59<p>
602008/10/07 Initial version.
61</p>
62
63<hr><p>CONFIDENTIAL</p></body>
64</html>
65