Top |
GdaConnectionEventGdaConnectionEvent — Any event which has occurred on a GdaConnection |
Functions
Types and Values
enum | GdaConnectionEventType |
enum | GdaConnectionEventCode |
#define | GDA_SQLSTATE_NO_ERROR |
#define | GDA_SQLSTATE_GENERAL_ERROR |
Description
Events occurring on a connection are each represented as a GdaConnectionEvent object. Each GdaConnection
is responsible for keeping a list of past events; that list can be consulted using the
gda_connection_get_events()
function.
Functions
gda_connection_event_set_event_type ()
void gda_connection_event_set_event_type (GdaConnectionEvent *event
,GdaConnectionEventType type
);
Sets event
's severity (from a simple notice to a fatal event)
This function should not be called directly.
gda_connection_event_get_event_type ()
GdaConnectionEventType
gda_connection_event_get_event_type (GdaConnectionEvent *event
);
Get event
's severity (from a simple notice to a fatal event)
gda_connection_event_get_description ()
const gchar *
gda_connection_event_get_description (GdaConnectionEvent *event
);
Get the description of the event. Note that is event
's type is GDA_CONNECTION_EVENT_COMMAND,
the the description is the SQL of the command.
gda_connection_event_set_description ()
void gda_connection_event_set_description (GdaConnectionEvent *event
,const gchar *description
);
Sets event
's description
. This function should not be called directly.
Parameters
event |
||
description |
a description, or |
[allow-none] |
gda_connection_event_set_code ()
void gda_connection_event_set_code (GdaConnectionEvent *event
,glong code
);
Sets event
's code: the code is specific to the provider being used.
If you want to have a common understanding of the event codes, use
gda_connection_event_get_gda_code()
instead.
This function should not be called directly
gda_connection_event_get_gda_code ()
GdaConnectionEventCode
gda_connection_event_get_gda_code (GdaConnectionEvent *event
);
Retrieve the code associated to event
.
gda_connection_event_set_gda_code ()
void gda_connection_event_set_gda_code (GdaConnectionEvent *event
,GdaConnectionEventCode code
);
Sets event
's gda code: that code is standardized by the libgda
library. If you want to specify the corresponding provider specific code,
use gda_connection_event_get_code()
or gda_connection_event_get_sqlstate()
instead.
This function should not be called directly
gda_connection_event_get_source ()
const gchar *
gda_connection_event_get_source (GdaConnectionEvent *event
);
gda_connection_event_set_source ()
void gda_connection_event_set_source (GdaConnectionEvent *event
,const gchar *source
);
Sets event
's source
; this function should not be called directly
gda_connection_event_get_sqlstate ()
const gchar *
gda_connection_event_get_sqlstate (GdaConnectionEvent *event
);
Get the SQLSTATE value of event
. Even though the SQLSTATE values are specified by ANSI SQL and ODBC,
consult each DBMS for the possible values. However, the "00000" (success) value means that there is no error,
and the "HY000" (general error) value means an error but no better error code available.
gda_connection_event_set_sqlstate ()
void gda_connection_event_set_sqlstate (GdaConnectionEvent *event
,const gchar *sqlstate
);
Changes the SQLSTATE code of event
, this function should not be called directly
Sets event
's SQL state.
Property Details
The “type”
property
“type” gint
Connection event type.
Flags: Read / Write
Allowed values: [0,3]
Default value: 2