| 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 *vcnc);
GdaConnection * gda_virtual_connection_open (GdaVirtualProvider *virtual_provider,GError **error);
Creates and opens a new virtual connection using the virtual_provider provider. The returned value
is a new GdaVirtualConnection which needs to be used to actually add some contents to the virtual connection.
|
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_ISOLATED 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).
The returned value is a new GdaVirtualConnection which needs to be used to actually add some contents to the virtual connection.
|
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 *vcnc);
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
|
a GdaConnection object |
Returns : |
the pointer to the opaque structure set using gda_virtual_connection_internal_set_provider_data()
|