tpa-connection

tpa-connection

Synopsis




                    TpaIConnection;
void                tpa_connection_init                 (TpaIConnection *iface,
                                                         gpointer data);
void                tpa_connection_finalize             (GObject *obj);
gchar*              tpa_connection_get_string           (GObject *obj,
                                                         guint handle);
TpaHandle*          tpa_connection_get_handle           (GObject *obj,
                                                         TpaConnectionHandleType type,
                                                         const gchar *string);
#define             tpa_connection_get_contact_handle   (conn, string)
#define             tpa_connection_get_list_handle      (conn, string)
#define             tpa_connection_get_room_handle      (conn, string)
void                tpa_connection_signal_new_channel   (GObject *obj,
                                                         const gchar *obj_path,
                                                         TpaChannelType type,
                                                         const gchar *string,
                                                         gboolean suppress_handler);
void                tpa_connection_signal_status_changed
                                                        (GObject *obj,
                                                         TpaConnectionStatus status,
                                                         TpaConnectionStatusReason reason);

Description

Details

TpaIConnection

typedef struct {
    GTypeInterface parent;

    /* Virtual Methods */
    TpaError    (* connect)                 (GObject *obj);
    TpaError    (* disconnect)              (GObject *obj);
    TpaError    (* get_self_handle)         (GObject *obj,
                                             guint *ret);
    TpaError    (* get_interfaces)          (GObject *obj,
                                             gchar ***ret);
    TpaError    (* hold_handles)            (GObject *obj,
                                             guint handle_type,
                                             const GArray *handles);
    TpaError     (* inspect_handles)        (GObject *obj,
                                             guint handle_type,
                                             const GArray *handles,
                                             gchar **ret);
    TpaError     (* format_string)          (GObject *obj,
                                             const gchar *string,
                                             gchar **ret);
    TpaError     (* release_handles)        (GObject *obj,
                                             guint handle_type,
                                             const GArray *handles);
    TpaError     (* request_session)        (GObject *obj,
                                             const gchar *type,
                                             const gchar *string,
                                             gboolean suppress_handler);
    TpaError     (* request_handles)        (GObject *obj,
                                             guint handle_type,
                                             const gchar **names);
    TpaConnectionStatus status;
    TpaConnectionStatusReason reason;
    TpaHandle *handle;
    GHashTable *handles;
    GPtrArray *sessions;
    gchar *protocol;
} TpaIConnection;


tpa_connection_init ()

void                tpa_connection_init                 (TpaIConnection *iface,
                                                         gpointer data);

iface :
data :

tpa_connection_finalize ()

void                tpa_connection_finalize             (GObject *obj);

obj :

tpa_connection_get_string ()

gchar*              tpa_connection_get_string           (GObject *obj,
                                                         guint handle);

Returned string must be freed.

obj :
handle :
Returns :

tpa_connection_get_handle ()

TpaHandle*          tpa_connection_get_handle           (GObject *obj,
                                                         TpaConnectionHandleType type,
                                                         const gchar *string);

Get handle for given string, if it is not available yet create one. Given string must be normalized to protocol.

obj :
type :
string :
Returns :

tpa_connection_get_contact_handle()

#define             tpa_connection_get_contact_handle(conn, string)

conn :
string :

tpa_connection_get_list_handle()

#define             tpa_connection_get_list_handle(conn, string)

conn :
string :

tpa_connection_get_room_handle()

#define             tpa_connection_get_room_handle(conn, string)

conn :
string :

tpa_connection_signal_new_channel ()

void                tpa_connection_signal_new_channel   (GObject *obj,
                                                         const gchar *obj_path,
                                                         TpaChannelType type,
                                                         const gchar *string,
                                                         gboolean suppress_handler);

Implements DBus signal NewChannel on interface org.freedesktop.Telepathy.Connection

obj :
obj_path :
type :
string :
suppress_handler :

tpa_connection_signal_status_changed ()

void                tpa_connection_signal_status_changed
                                                        (GObject *obj,
                                                         TpaConnectionStatus status,
                                                         TpaConnectionStatusReason reason);

Implements DBus signal StatusChanged on interface org.freedesktop.Telepathy.Connection

obj :
status :
reason :