|  |  |  | GNOME Data Access manual |  | 
|---|---|---|---|---|
| GdaConnectionEventGdaConnectionEvent — Any event which has occurred on a GdaConnection | 
            GdaConnectionEvent;
            GdaConnectionEventPrivate;
enum        GdaConnectionEventType;
enum        GdaConnectionEventCode;
GdaConnectionEvent* gda_connection_event_new
                                            (GdaConnectionEventType type);
void        gda_connection_event_free       (GdaConnectionEvent *event);
GList*      gda_connection_event_list_copy  (const GList *events);
void        gda_connection_event_list_free  (GList *events);
void        gda_connection_event_set_event_type
                                            (GdaConnectionEvent *event,
                                             GdaConnectionEventType type);
GdaConnectionEventType gda_connection_event_get_event_type
                                            (GdaConnectionEvent *event);
const gchar* gda_connection_event_get_description
                                            (GdaConnectionEvent *event);
void        gda_connection_event_set_description
                                            (GdaConnectionEvent *event,
                                             const gchar *description);
glong       gda_connection_event_get_code   (GdaConnectionEvent *event);
void        gda_connection_event_set_code   (GdaConnectionEvent *event,
                                             glong code);
GdaConnectionEventCode gda_connection_event_get_gda_code
                                            (GdaConnectionEvent *event);
void        gda_connection_event_set_gda_code
                                            (GdaConnectionEvent *event,
                                             GdaConnectionEventCode code);
const gchar* gda_connection_event_get_source
                                            (GdaConnectionEvent *event);
void        gda_connection_event_set_source (GdaConnectionEvent *event,
                                             const gchar *source);
const gchar* gda_connection_event_get_sqlstate
                                            (GdaConnectionEvent *event);
void        gda_connection_event_set_sqlstate
                                            (GdaConnectionEvent *event,
                                             const gchar *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.
typedef enum {
	GDA_CONNECTION_EVENT_NOTICE,
	GDA_CONNECTION_EVENT_WARNING,
	GDA_CONNECTION_EVENT_ERROR
} GdaConnectionEventType;
typedef enum
{
       GDA_CONNECTION_EVENT_CODE_CONSTRAINT_VIOLATION,
       GDA_CONNECTION_EVENT_CODE_RESTRICT_VIOLATION,
       GDA_CONNECTION_EVENT_CODE_NOT_NULL_VIOLATION,
       GDA_CONNECTION_EVENT_CODE_FOREIGN_KEY_VIOLATION,
       GDA_CONNECTION_EVENT_CODE_UNIQUE_VIOLATION,
       GDA_CONNECTION_EVENT_CODE_CHECK_VIOLATION,
       GDA_CONNECTION_EVENT_CODE_INSUFFICIENT_PRIVILEGES,
       GDA_CONNECTION_EVENT_CODE_UNDEFINED_COLUMN,
       GDA_CONNECTION_EVENT_CODE_UNDEFINED_FUNCTION,
       GDA_CONNECTION_EVENT_CODE_UNDEFINED_TABLE,
       GDA_CONNECTION_EVENT_CODE_DUPLICATE_COLUMN,
       GDA_CONNECTION_EVENT_CODE_DUPLICATE_DATABASE,
       GDA_CONNECTION_EVENT_CODE_DUPLICATE_FUNCTION,
       GDA_CONNECTION_EVENT_CODE_DUPLICATE_SCHEMA,
       GDA_CONNECTION_EVENT_CODE_DUPLICATE_TABLE,
       GDA_CONNECTION_EVENT_CODE_DUPLICATE_ALIAS,
       GDA_CONNECTION_EVENT_CODE_DUPLICATE_OBJECT,
       GDA_CONNECTION_EVENT_CODE_SYNTAX_ERROR,
       GDA_CONNECTION_EVENT_CODE_UNKNOWN
} GdaConnectionEventCode;
GdaConnectionEvent* gda_connection_event_new (GdaConnectionEventType type);
| type: | |
| Returns : | 
void gda_connection_event_free (GdaConnectionEvent *event);
Frees the memory allocated by the event object.
| event: | 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.
| events: | a GList holding event objects. | 
| Returns : | a list of events. | 
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.
| events: | a GList holding event objects. | 
void        gda_connection_event_set_event_type
                                            (GdaConnectionEvent *event,
                                             GdaConnectionEventType type);
Sets event's severity (from a simple notice to a fatal event)
| event: | a GdaConnectionEvent object | 
| type: | the severity of the event | 
GdaConnectionEventType gda_connection_event_get_event_type (GdaConnectionEvent *event);
Get event's severity (from a simple notice to a fatal event)
| event: | a GdaConnectionEvent object | 
| Returns : | the event type | 
const gchar* gda_connection_event_get_description
                                            (GdaConnectionEvent *event);
| event: | a GdaConnectionEvent. | 
| Returns : | event's description. | 
void        gda_connection_event_set_description
                                            (GdaConnectionEvent *event,
                                             const gchar *description);
Sets event's description.
| event: | a GdaConnectionEvent. | 
| description: | a description. | 
glong gda_connection_event_get_code (GdaConnectionEvent *event);
| event: | a GdaConnectionEvent. | 
| Returns : | event's code (the code is specific to the provider being used) | 
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.
| event: | a GdaConnectionEvent. | 
| code: | a code. | 
GdaConnectionEventCode gda_connection_event_get_gda_code (GdaConnectionEvent *event);
Retreive the code associated to event.
| event: | a GdaConnectionEvent | 
| Returns : | the GdaConnectionEventCode event's 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() instead.
| event: | a GdaConnectionEvent | 
| code: | a code | 
const gchar* gda_connection_event_get_source
                                            (GdaConnectionEvent *event);
| event: | a GdaConnectionEvent. | 
| Returns : | event's source. | 
void gda_connection_event_set_source (GdaConnectionEvent *event, const gchar *source);
Sets event's source.
| event: | a GdaConnectionEvent. | 
| source: | a source. | 
const gchar* gda_connection_event_get_sqlstate
                                            (GdaConnectionEvent *event);
| event: | a GdaConnectionEvent. | 
| Returns : | event's SQL state. | 
void        gda_connection_event_set_sqlstate
                                            (GdaConnectionEvent *event,
                                             const gchar *sqlstate);
Sets event's SQL state.
| event: | a GdaConnectionEvent. | 
| sqlstate: | SQL state. |