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.

Behavior is undefined if a function such as TCL_EncodeAndWritePicture, TCL_SortTable, or TCL_DeletePicture changes the number or order of photos being managed during a search.

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

See Also

TCL_InitSearchObject

Revision History

2009/03/23 Added a condition when behavior would be undefined.
2009/03/04 Fixed typos.
2008/10/07 Initial version.


CONFIDENTIAL