| GNOME Data Access 4.0 manual | ||||
|---|---|---|---|---|
GdaVirtualConnection;
GdaConnection* gda_virtual_connection_open (GdaVirtualProvider *virtual_provider,
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
| virtual_provider : | a GdaVirtualProvider object |
| error : | 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.
| vcnc : | a GdaConnection object |
| data : | an opaque structure, known only to the provider for which vcnc is opened |
| destroy_func : | 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
| cnc : | |
| Returns : | the pointer to the opaque structure set using gda_virtual_connection_internal_set_provider_data() |