![]() |
![]() |
![]() |
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()
|