GdaConnectionEvent

GdaConnectionEvent — Any event which has occurred on a GdaConnection

Functions

Properties

gint type Read / Write

Types and Values

Object Hierarchy

    GObject
    ╰── GdaConnectionEvent

Description

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.

Functions

gda_connection_event_new ()

GdaConnectionEvent *
gda_connection_event_new (GdaConnectionEventType type);

Returns


gda_connection_event_free ()

void
gda_connection_event_free (GdaConnectionEvent *event);

Frees the memory allocated by the event object.

Parameters

event

the event object.

 

gda_connection_event_list_copy ()

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.

Parameters

events

a GList holding event objects.

 

Returns

a list of events.


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.

Parameters

events

a GList holding event objects.

 

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)

Parameters

event

a GdaConnectionEvent object

 

type

the severity of the event

 

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)

Parameters

event

a GdaConnectionEvent object

 

Returns

the event type


gda_connection_event_get_description ()

const gchar *
gda_connection_event_get_description (GdaConnectionEvent *event);

Parameters

event

a GdaConnectionEvent.

 

Returns

event 's description.


gda_connection_event_set_description ()

void
gda_connection_event_set_description (GdaConnectionEvent *event,
                                      const gchar *description);

Sets event 's description .

Parameters

event

a GdaConnectionEvent.

 

description

a description.

 

gda_connection_event_get_code ()

glong
gda_connection_event_get_code (GdaConnectionEvent *event);

Parameters

event

a GdaConnectionEvent.

 

Returns

event 's code (the code is specific to the provider being used)


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.

Parameters

event

a GdaConnectionEvent.

 

code

a code.

 

gda_connection_event_get_gda_code ()

GdaConnectionEventCode
gda_connection_event_get_gda_code (GdaConnectionEvent *event);

Retreive the code associated to event .

Parameters

event

a GdaConnectionEvent

 

Returns

the GdaConnectionEventCode event's code


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() instead.

Parameters

event

a GdaConnectionEvent

 

code

a code

 

gda_connection_event_get_source ()

const gchar *
gda_connection_event_get_source (GdaConnectionEvent *event);

Parameters

event

a GdaConnectionEvent.

 

Returns

event 's source.


gda_connection_event_set_source ()

void
gda_connection_event_set_source (GdaConnectionEvent *event,
                                 const gchar *source);

Sets event 's source .

Parameters

event

a GdaConnectionEvent.

 

source

a source.

 

gda_connection_event_get_sqlstate ()

const gchar *
gda_connection_event_get_sqlstate (GdaConnectionEvent *event);

Parameters

event

a GdaConnectionEvent.

 

Returns

event 's SQL state.


gda_connection_event_set_sqlstate ()

void
gda_connection_event_set_sqlstate (GdaConnectionEvent *event,
                                   const gchar *sqlstate);

Sets event 's SQL state.

Parameters

event

a GdaConnectionEvent.

 

sqlstate

SQL state.

 

Types and Values

GdaConnectionEvent

typedef struct _GdaConnectionEvent GdaConnectionEvent;


GdaConnectionEventPrivate

typedef struct _GdaConnectionEventPrivate GdaConnectionEventPrivate;


enum GdaConnectionEventType

Members

GDA_CONNECTION_EVENT_NOTICE

   

GDA_CONNECTION_EVENT_WARNING

   

GDA_CONNECTION_EVENT_ERROR

   

enum GdaConnectionEventCode

Members

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

   

Property Details

The “type” property

  “type”                     gint

Connection event type.

Flags: Read / Write

Allowed values: [0,2]

Default value: 2