Завершите Changeset Iterator

int sqlite3changeset_finalize(sqlite3_changeset_iter *pIter);

Эта функция используется, чтобы завершить iterator, ассигнованный sqlite3changeset_start().

К этой функции нужно обратиться только в итераторах, созданных с использованием функции sqlite3changeset_start(). Если применение вызывает эту функцию с iterator, переданным обработчику конфликта sqlite3changeset_apply(), SQLITE_MISUSE немедленно возвращен, и вызов не имеет никакого эффекта.

Если с ошибкой столкнулись в рамках обращения к sqlite3changeset_xxx() (например, SQLITE_CORRUPT в sqlite3changeset_next() или SQLITE_NOMEM в sqlite3changeset_new()), код ошибки, соответствующий той ошибке, возвращен этой функцией. Иначе SQLITE_OK возвращен. Это должно позволить следующий образец (псевдокод):

sqlite3changeset_start();
while( SQLITE_ROW==sqlite3changeset_next() )
{
  // Do something with change.
}
rc = sqlite3changeset_finalize();
if( rc!=SQLITE_OK )
{
  // An error has occurred
}