int sqlite3_unlock_notify( sqlite* db, notify_callback, void* arg ); void notify_callback( void** argv, int argc );
db
A database connection.
notify_callback
The unlock notification callback function.
arg
An application-specific notification record.
argv
An array of notification records.
argc
The number of notification records.
sqlite3_unlock_notify())An SQLite result code.
This function registers an unlock notification callback. This
can only be used in shared cache mode. If a database connection
returns an SQLITE_LOCKED
error, the application has a chance to install an unlock
notification callback. This callback will be called when the
lock becomes available, giving the callback a chance to process
all of the outstanding notification records.
This is an advanced API call that requires significant understanding of the threading and locking modes used by a shared cache. For more information, see http://www.sqlite.org/unlock_notify.html.
This function is only available if the SQLite library was
compiled with the SQLITE_ENABLE_UNLOCK_NOTIFY build
option.