| GNOME Data Access 4 manual | ||||
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | ||||
GdaVirtualConnection;
GdaConnection * gda_virtual_connection_open (GdaVirtualProvider *virtual_provider,
GError **error);
GdaConnection * gda_virtual_connection_open_extended
(GdaVirtualProvider *virtual_provider,
GdaConnectionOptions options,
GError **error);
void gda_virtual_connection_internal_set_provider_data
(GdaVirtualConnection *vcnc,
gpointer data,
GDestroyNotify destroy_func);
gpointer gda_virtual_connection_internal_get_provider_data
(GdaVirtualConnection *cnc);
GdaConnection * gda_virtual_connection_open (GdaVirtualProvider *virtual_provider, GError **error);
Creates and opens a new virtual connection using the virtual_provider provider
|
a GdaVirtualProvider object |
|
a place to store errors, or NULL
|
Returns : |
a new GdaConnection object, or NULL if an error occurred
|
GdaConnection * gda_virtual_connection_open_extended (GdaVirtualProvider *virtual_provider, GdaConnectionOptions options, GError **error);
Creates and opens a new virtual connection using the virtual_provider provider. If options
contains the GDA_CONNECTION_OPTIONS_THREAD_SAFE flag, then the returned connection will be
a thread wrapped connection, and the actual (wrapped) virtual connection can be obtained through
the "gda-virtual-connection" user property (use g_object_get_data() to get it).
|
a GdaVirtualProvider object |
|
a set of options to specify the new connection |
|
a place to store errors, or NULL
|
Returns : |
a new GdaConnection object, or NULL if an error occurred
|
void gda_virtual_connection_internal_set_provider_data
(GdaVirtualConnection *vcnc,
gpointer data,
GDestroyNotify destroy_func);
Note: calling this function more than once will not make it call destroy_func on any previously
set opaque data, you'll have to do it yourself.
|
a GdaConnection object |
|
an opaque structure, known only to the provider for which vcnc is opened
|
|
function to call when the connection closes and data needs to be destroyed
|
gpointer gda_virtual_connection_internal_get_provider_data (GdaVirtualConnection *cnc);
Get the opaque pointer previously set using gda_virtual_connection_internal_set_provider_data().
If it's not set, then add a connection event and returns NULL
|
|
Returns : |
the pointer to the opaque structure set using gda_virtual_connection_internal_set_provider_data()
|