TCL_SearchNextPicturePath

Definition

#include <twl/tcl.h>


TCLResult TCL_SearchNextPicturePath( const TCLAccessor* pAccessor ,
                                     char* path ,
                                     size_t len ,
                                     TCLSearchObject* pSearchObj );
	

Arguments

pAccessorAccessor
pathBuffer that stores the path
lenPath length
pSearchObjSearch object

Return Values

Processing result

Description

Each call to this function gets the storage path to the next photo that completely matches the search conditions specified by the search object.

If no next photo matches the search conditions, TCL_RESULT_ERROR_NO_FIND_PICTURE is returned.

If the returned value is not TCL_RESULT_SUCCESS, the path value is undefined.

While searching, if a function such as TCL_EncodeAndWritePicture or TCL_SortTable changes the number or order of photos being managed, the search behavior is no longer defined.

The accessor must be initialized by the TCL_LoadTable or TCL_CreateTable functions.

See Also

TCL_InitSearchObject

Revision History

2009/03/04 Corrected errors.
2008/10/07 Initial version.


CONFIDENTIAL