# TCL_SearchNextPictureInfo

## 定義

  `#include <twl/tcl.h>`

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

## 引数

pAccessor | アクセサ
ppPicInfo | 見つかった写真情報を格納するポインタ
pSearchObj | 検索オブジェクト

## 返り値

処理結果

## 説明

検索オブジェクトで表される検索条件に全て合致する写真情報を、この関数の呼出し毎に順次取得します。

最後まで検索を行い次の写真が見つからなかった場合 `TCL_RESULT_ERROR_NO_FIND_PICTURE` が返ってきます。

返り値が `TCL_RESULT_SUCCESS` 以外の場合は取得される写真情報の値は不定です。

検索処理中に `TCL_EncodeAndWritePicture` や `TCL_SortTable` 、`TCL_DeletePicture` など、管理される写真の枚数の増減や順番変更が発生するような処理を行った場合の挙動は不定です。

アクセサは `TCL_LoadTable` や `TCL_CreateTable` などで初期化されている必要があります。

## 参照

`TCL_InitSearchObject`

## 履歴

2009/03/23 動作が不定となる条件を追加
2009/03/04 誤記修正
2008/10/07 初版