GdaVirtualConnection

GdaVirtualConnection — Base class for all virtual connection objects

Stability Level

Stable, unless otherwise indicated

Object Hierarchy

    GObject
    ╰── GdaConnection
        ╰── GdaVirtualConnection
            ╰── GdaVconnectionDataModel

Description

This is a base virtual class for all virtual connection implementations.

Functions

gda_virtual_connection_open ()

GdaConnection *
gda_virtual_connection_open (GdaVirtualProvider *virtual_provider,
                             GdaConnectionOptions options,
                             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.

Parameters

virtual_provider

a GdaVirtualProvider object

 

options

some options

 

error

a place to store errors, or NULL

 

Returns

a new GdaConnection object, or NULL if an error occurred


gda_virtual_connection_internal_set_provider_data ()

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.

Parameters

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

 

gda_virtual_connection_internal_get_provider_data ()

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

Parameters

vcnc

a GdaConnection object

 

Returns

the pointer to the opaque structure set using gda_virtual_connection_internal_set_provider_data()

Types and Values