Получение объединённого набора изменений из группы изменений

int sqlite3changegroup_output(
  sqlite3_changegroup*,
  int *pnData,                    /* OUT: Size of output buffer in bytes */
  void **ppData                   /* OUT: Pointer to output buffer */
);

Получить буфер, содержащий набор изменений (или набор исправлений), представляющий текущее содержимое группы изменений. Если входные данные группы изменений были сами наборами изменений, на выходе будет набор изменений. Или, если входные данные были наборами исправлений, на выходе также будет набор исправлений.

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

Если произошла ошибка, возвращается код ошибки SQLite, а переменные вывода (*pnData) и (*ppData) устанавливаются в 0. В противном случае возвращается SQLITE_OK, и переменные вывода устанавливаются в размер и указатель на выходной буфер соответственно. В этом случае ответственность за освобождение буфера возлагается на вызывающую функцию с помощью вызова sqlite3_free().

См. также списки Объектов, Констант и Функций.