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 <twl/tcl.h></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