From 63847496f14c813a5d80efd5b7de0f1294ffe1e3 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sat, 13 Apr 2024 16:07:11 +0200 Subject: Adding upstream version 3.45.1. Signed-off-by: Daniel Baumann --- www/session/sqlite3session_create.html | 154 +++++++++++++++++++++++++++++++++ 1 file changed, 154 insertions(+) create mode 100644 www/session/sqlite3session_create.html (limited to 'www/session/sqlite3session_create.html') diff --git a/www/session/sqlite3session_create.html b/www/session/sqlite3session_create.html new file mode 100644 index 0000000..4501259 --- /dev/null +++ b/www/session/sqlite3session_create.html @@ -0,0 +1,154 @@ + + + + + +Create A New Session Object + + + +
+ + + +
+
+Small. Fast. Reliable.
Choose any three. +
+
+ +
+ +
+
+ + + +
+
+
+ +

Session Module C Interface

Create A New Session Object

int sqlite3session_create(
+  sqlite3 *db,                    /* Database handle */
+  const char *zDb,                /* Name of db (e.g. "main") */
+  sqlite3_session **ppSession     /* OUT: New session object */
+);
+

+Create a new session object attached to database handle db. If successful, +a pointer to the new object is written to *ppSession and SQLITE_OK is +returned. If an error occurs, *ppSession is set to NULL and an SQLite +error code (e.g. SQLITE_NOMEM) is returned.

+ +

It is possible to create multiple session objects attached to a single +database handle.

+ +

Session objects created using this function should be deleted using the +sqlite3session_delete() function before the database handle that they +are attached to is itself closed. If the database handle is closed before +the session object is deleted, then the results of calling any session +module function, including sqlite3session_delete() on the session object +are undefined.

+ +

Because the session module uses the sqlite3_preupdate_hook() API, it +is not possible for an application to register a pre-update hook on a +database handle that has one or more session objects attached. Nor is +it possible to create a session object attached to a database handle for +which a pre-update hook is already defined. The results of attempting +either of these things are undefined.

+ +

The session object will be used to create changesets for tables in +database zDb, where zDb is either "main", or "temp", or the name of an +attached database. It is not an error if database zDb is not attached +to the database when the session object is created. +

See also lists of + Objects, + Constants, and + Functions.

+ -- cgit v1.2.3