Top | ![]() |
![]() |
![]() |
![]() |
GdaConnectionEventGdaConnectionEvent — Any event which has occurred on a GdaConnection |
GdaConnectionEvent * | gda_connection_event_new () |
void | gda_connection_event_free () |
GList * | gda_connection_event_list_copy () |
void | gda_connection_event_list_free () |
void | gda_connection_event_set_event_type () |
GdaConnectionEventType | gda_connection_event_get_event_type () |
const gchar * | gda_connection_event_get_description () |
void | gda_connection_event_set_description () |
glong | gda_connection_event_get_code () |
void | gda_connection_event_set_code () |
GdaConnectionEventCode | gda_connection_event_get_gda_code () |
void | gda_connection_event_set_gda_code () |
const gchar * | gda_connection_event_get_source () |
void | gda_connection_event_set_source () |
const gchar * | gda_connection_event_get_sqlstate () |
void | gda_connection_event_set_sqlstate () |
Events occuring 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.
GdaConnectionEvent *
gda_connection_event_new (GdaConnectionEventType type
);
void
gda_connection_event_free (GdaConnectionEvent *event
);
Frees the memory allocated by the event object.
GList *
gda_connection_event_list_copy (const GList *events
);
Creates a new list which contains the same events as events
and
adds a reference for each event in the list.
You must free the list using gda_connection_event_list_free.
void
gda_connection_event_list_free (GList *events
);
Frees all event objects in the list and the list itself.
After this function has been called, the events
parameter doesn't point
to valid storage any more.
void gda_connection_event_set_event_type (GdaConnectionEvent *event
,GdaConnectionEventType type
);
Sets event
's severity (from a simple notice to a fatal event)
GdaConnectionEventType
gda_connection_event_get_event_type (GdaConnectionEvent *event
);
Get event
's severity (from a simple notice to a fatal event)
const gchar *
gda_connection_event_get_description (GdaConnectionEvent *event
);
void gda_connection_event_set_description (GdaConnectionEvent *event
,const gchar *description
);
Sets event
's description
.
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.
GdaConnectionEventCode
gda_connection_event_get_gda_code (GdaConnectionEvent *event
);
Retreive the code associated to event
.
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()
instead.
const gchar *
gda_connection_event_get_source (GdaConnectionEvent *event
);
void gda_connection_event_set_source (GdaConnectionEvent *event
,const gchar *source
);
Sets event
's source
.
const gchar *
gda_connection_event_get_sqlstate (GdaConnectionEvent *event
);
void gda_connection_event_set_sqlstate (GdaConnectionEvent *event
,const gchar *sqlstate
);
Sets event
's SQL state.