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