# TCL_SearchNextPictureInfo

## Definition

  `#include <twl/tcl.h>`

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

## Arguments

pAccessor | Accessor
ppPicInfo | Pointer to where search information is stored
pSearchObj | Search 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