TCL_LoadTable

Definition

#include <twl/tcl.h>


TCLResult TCL_LoadTable( TCLAccessor* pAccessor ,
                         void* tableBuffer ,
                         u32 tableBufferSize ,
                         void* workBuffer ,
                         u32 workBufferSize ,
                         FSResult* pFSResult );
	

Arguments

pAccessorAccessor
tableBufferBuffer for loading the management file
tableBufferSizeSize of the buffer for loading the management file
workBufferWorking buffer
workBufferSizeSize of the working buffer
pFSResultProcessing result when an error has been generated by an FS function inside this function

Return Values

Processing result

Description

Loads the management file.

For tableBuffer and tableBufferSize, specify a buffer and a buffer size. The buffer size is determined by the TCL_GetTableBufferSize function.

For workBuffer and workBufferSize, specify a buffer and a buffer size. The buffer size is determined by the TCL_GetWorkBufferSize function.

The values returned by this function are explained in the following table.
TCL_RESULT_SUCCESSLoading and writing are both possible
TCL_RESULT_ERROR_EXIST_OTHER_FILE
TCL_RESULT_ERROR_ALREADY_MANAGED
Loading is possible; writing is not possible
OtherNeither loading nor writing is possible

If the process only loads photos and no write operation is needed, the process can continue even if the function returns TCL_RESULT_ERROR_EXIST_OTHER_FILE or TCL_RESULT_ERROR_ALREADY_MANAGED.

If the process involves writing photos, use the TCL_RepairTable function to enable writing if either of those two errors is returned.

If some other error is returned, neither loading nor writing is possible. Use the TCL_CreateTable function to regenerate the management file.

See Also

TCL_RepairTable
TCL_CreateTable

Revision History

2008/10/07 Initial version.


CONFIDENTIAL