Объекты виртуальной файловой системы

sqlite3_vfs *sqlite3_vfs_find(const char *zVfsName);
int sqlite3_vfs_register(sqlite3_vfs*, int makeDflt);
int sqlite3_vfs_unregister(sqlite3_vfs*);

Виртуальная файловая система (VFS) — это объект sqlite3_vfs, который SQLite использует для взаимодействия с базовой операционной системой. Большинство сборок SQLite поставляются с одной стандартной VFS, подходящей для компьютера-хоста. Новые VFS могут быть зарегистрированы, а существующие — дезактивированы. Ниже приведены предоставляемые интерфейсы.

Интерфейс sqlite3_vfs_find() возвращает указатель на VFS по её имени. Имена чувствительны к регистру. Имена являются нуль-терминированными UTF-8 строками. Если совпадения нет, возвращается нулевой указатель. Если zVfsName равен NULL, возвращается стандартная VFS.

Новые VFS регистрируются с помощью sqlite3_vfs_register(). Каждая новая VFS становится стандартной VFS, если установлен флаг makeDflt. Одну и ту же VFS можно регистрировать несколько раз без повреждений. Чтобы сделать существующую VFS стандартной, её нужно зарегистрировать ещё раз с установленным флагом makeDflt. Если две разные VFS с одинаковым именем зарегистрированы, поведение не определено. Если VFS зарегистрирована с именем NULL или пустой строкой, поведение не определено.

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

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