Состояние подключения к базе данных

int sqlite3_db_status(sqlite3*, int op, int *pCur, int *pHiwtr, int resetFlg);
int sqlite3_db_status64(sqlite3*,int,sqlite3_int64*,sqlite3_int64*,int);

Этот интерфейс используется для получения сведений о состоянии во время выполнения отдельного подключения к базе данных. Первый аргумент — объект подключения к базе данных, состояние которого нужно проверить. Второй аргумент — целочисленная константа из набора параметров SQLITE_DBSTATUS, определяющая проверяемый параметр. В будущих выпусках SQLite набор параметров SQLITE_DBSTATUS, вероятно, будет расширяться.

Текущее значение запрошенного параметра записывается в *pCur, а наибольшее мгновенное значение — в *pHiwtr. Если resetFlg имеет значение true, наибольшее мгновенное значение сбрасывается до текущего.

При успешном выполнении процедура sqlite3_db_status() возвращает SQLITE_OK, а при сбое — ненулевой код ошибки.

Процедура sqlite3_db_status64(D,O,C,H,R) работает точно так же, как sqlite3_db_status(D,O,C,H,R), за исключением того, что параметры C и H — это указатели на 64-разрядные целые числа (тип: sqlite3_int64), а не указатели на 32-разрядные целые числа, что позволяет возвращать более крупные значения состояния. Если значение состояния превышает 2,147,483,647, sqlite3_db_status() усечёт его, тогда как sqlite3_db_status64() вернёт полное значение.

См. также: sqlite3_status() и sqlite3_stmt_status().

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