| GNOME Data Access manual |
|---|
GdaConnectionEventGdaConnectionEvent — Any event which has occured 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. |
| << GdaConnection | Commands >> |