Top | ![]() |
![]() |
![]() |
![]() |
GdaConnectionEventGdaConnectionEvent — Any event which has occurred on a GdaConnection |
enum | GdaConnectionEventType |
enum | GdaConnectionEventCode |
#define | GDA_SQLSTATE_NO_ERROR |
#define | GDA_SQLSTATE_GENERAL_ERROR |
Events occurring 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.
void gda_connection_event_set_event_type (GdaConnectionEvent *event
,GdaConnectionEventType type
);
Sets event
's severity (from a simple notice to a fatal event)
This function should not be called directly.
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
);
Get the description of the event. Note that is event
's type is GDA_CONNECTION_EVENT_COMMAND,
the the description is the SQL of the command.
void gda_connection_event_set_description (GdaConnectionEvent *event
,const gchar *description
);
Sets event
's description
. This function should not be called directly.
event |
||
description |
a description, or |
[allow-none] |
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.
This function should not be called directly
GdaConnectionEventCode
gda_connection_event_get_gda_code (GdaConnectionEvent *event
);
Retrieve 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()
or gda_connection_event_get_sqlstate()
instead.
This function should not be called directly
const gchar *
gda_connection_event_get_source (GdaConnectionEvent *event
);
void gda_connection_event_set_source (GdaConnectionEvent *event
,const gchar *source
);
Sets event
's source
; this function should not be called directly
const gchar *
gda_connection_event_get_sqlstate (GdaConnectionEvent *event
);
Get the SQLSTATE value of event
. Even though the SQLSTATE values are specified by ANSI SQL and ODBC,
consult each DBMS for the possible values. However, the "00000" (success) value means that there is no error,
and the "HY000" (general error) value means an error but no better error code available.
void gda_connection_event_set_sqlstate (GdaConnectionEvent *event
,const gchar *sqlstate
);
Changes the SQLSTATE code of event
, this function should not be called directly
Sets event
's SQL state.
“type”
property“type” gint
Connection event type.
Flags: Read / Write
Allowed values: [0,3]
Default value: 2