FreeBSD manual
download PDF document: mysql_session_track_get_first.3.pdf
mysql_session_track_get_first(3) MariaDB Connector/C
Name
mysql_session_track_get_first - retrieves first session status change
information
Synopsis
#include <mysql.h>
int mysql_session_track_get_first(MYSQL * mysql,
enum enum_session_state_type type,
const char **data,
size_t *length );
Description
mysql_session_track_get_first() retrieves the first session status
change information received from the server.
Depending on the specified type the read only data pointer will contain
the following information: * SESSION_TRACK_SCHEMA: The name of the
default schema (database) * SESSION_TRACK_SYSTEM_VARIABLES: If a
session system variable is changed, the first call contains the name of
the changed system variable, the second call contains the new value.
Both name and value are represented as strings. *
SESSION_TRACK_STATE_CHANGE: shows whether the session status has
changed. The value is changed as string "1" (changed) or "0"
(unchanged).
Further data needs to be obtained by calling
mysql_session_track_get_next(3).
Parameter
o mysql - mysql handle, which was previously allocated by mysql_init(3)
and connected by mysql_real_connect(3).
o type - type of information. Valid values are
o SESSION_TRACK_SYSTEM_VARIABLES
o SESSION_TRACK_SCHEMA
o SESSION_TRACK_STATE_CHANGE
o SESSION_TRACK_GTIDS (unsupported)
o data - pointer to data, which must be declared as const char *
o length - pointer to a size_t variable, which will contain the length
of data
Returns
Zero for success, nonzero if no session tracking information is
available.
History
mysql_session_track_get_first() was added in Connector/C 3.0 and
MariaDB Server 10.2.