GdaConnectionEvent

## GdaConnectionEvent GdaConnectionEvent — |

## Synopsis

                GdaConnectionEventPrivate;
    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);
    GdaConnectionEventCode gda_connection_event_get_gda_code
                                                (GdaConnectionEvent *event);
    void        gda_connection_event_set_gda_code
                                                (GdaConnectionEvent *event,
                                                 GdaConnectionEventCode code);
    glong       gda_connection_event_get_code   (GdaConnectionEvent *event);
    void        gda_connection_event_set_code   (GdaConnectionEvent *event,
                                                 glong 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);

## Description

## Details

### GdaConnectionEventPrivate

    typedef struct _GdaConnectionEventPrivate GdaConnectionEventPrivate;

### gda_connection_event_new ()

    GdaConnectionEvent* gda_connection_event_new
                                                (GdaConnectionEventType type);

`type` : |
Returns : |

### gda_connection_event_free ()

    void        gda_connection_event_free       (GdaConnectionEvent *event);

Frees the memory allocated by the event object.

`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.

`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.

`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)

`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)

`event` : | a GdaConnectionEvent object
Returns : | the event type

### gda_connection_event_get_description ()

    const gchar* gda_connection_event_get_description
                                                (GdaConnectionEvent *event);

`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`.

`event` : | a GdaConnectionEvent.
`description` : | a description.

### gda_connection_event_get_gda_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

### 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.

`event` : | a GdaConnectionEvent
`code` : | a code

### gda_connection_event_get_code ()

    glong       gda_connection_event_get_code   (GdaConnectionEvent *event);

`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.

`event` : | a GdaConnectionEvent.
`code` : | a code.

### gda_connection_event_get_source ()

    const gchar* gda_connection_event_get_source
                                                (GdaConnectionEvent *event);

`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`.

`event` : | a GdaConnectionEvent.
`source` : | a source.

### gda_connection_event_get_sqlstate ()

    const gchar* gda_connection_event_get_sqlstate
                                                (GdaConnectionEvent *event);

`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.

`event` : | a GdaConnectionEvent.
`sqlstate` : | SQL state.