# TCL_SearchNextPicturePath

## Definition

  `#include <twl/tcl.h>`

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

## Arguments

pAccessor | Accessor
path | Buffer that stores the path
len | Path length
pSearchObj | Search 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