TCL_SearchNextPictureInfo

Definition

#include <twl/tcl.h>


TCLResult TCL_SearchNextPictureInfo( const TCLAccessor* pAccessor ,
                                     const TCLPictureInfo** ppPicInfo ,
                                     TCLSearchObject* pSearchObj );
	

Arguments

pAccessorAccessor
ppPicInfoPointer to where search information is stored
pSearchObjSearch object

Return Values

Processing result

Description

Gets the information for the next photo that matches the search conditions defined by the pSearchObj argument.

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 retrieved information 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