Установить код и сообщение об ошибке

int sqlite3_set_errmsg(sqlite3 *db, int errcode, const char *zErrMsg);

Устанавливает код ошибки дескриптора базы данных, переданного в качестве первого аргумента, в значение errcode, а сообщение об ошибке — в копию строки zErrMsg, завершающейся нулевым символом. Если в качестве zErrMsg передано значение NULL, сообщение об ошибке устанавливается в значение сообщения по умолчанию, связанного с указанным кодом ошибки. Последующие вызовы sqlite3_errcode() и sqlite3_errmsg() и аналогичных функций будут возвращать значения, установленные этой процедурой, вместо значений, ранее установленных самой SQLite.

Эта функция возвращает SQLITE_OK, если код и сообщение об ошибке успешно установлены, SQLITE_NOMEM при нехватке памяти и SQLITE_MISUSE, если дескриптор базы данных равен NULL или недействителен.

Код и сообщение об ошибке, установленные этой процедурой, сохраняются до тех пор, пока не будут изменены другим вызовом этой процедуры или самой SQLite для отражения результата некоторого последующего вызова API.

Эта функция предназначена для использования расширениями SQLite или обёртками. Идея заключается в том, что расширение или обёртка может использовать эту процедуру для установки сообщений и кодов ошибок и тем самым вести себя с точки зрения приложения подобно встроенной функции SQLite.

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