diff -r d0f3a028347a -r 59927b2d3b75 libtelepathy/inc/tp-conn.h --- a/libtelepathy/inc/tp-conn.h Tue Feb 02 01:10:06 2010 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,220 +0,0 @@ -/* tp-conn.h - * - * - * Copyright (C) 2005 Collabora Ltd. - * This library is free software; you can redistribute it and/or - * modify it under the terms of the GNU Lesser General Public - * License as published by the Free Software Foundation; either - * version 2.1 of the License, or (at your option) any later version. - * - * This library is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - * Lesser General Public License for more details. - * - * You should have received a copy of the GNU Lesser General Public - * License along with this library; if not, write to the Free Software - * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA - * - */ - - -#ifndef TP_CONN_H -#define TP_CONN_H - -#ifndef DBUS_API_SUBJECT_TO_CHANGE -#define DBUS_API_SUBJECT_TO_CHANGE -#endif - -#include "tp-conn-gen.h" -#include "tp-conn-iface-forwarding-gen.h" -#include "tp-chan.h" -#include "tp-conn-signals-marshal.h" -#include "tp-ifaces-signals-marshal.h" -#include "tp-conn-ifaces-signal-setters.h" -#include "tp-interfaces.h" -#include "tp-constants.h" - -#include - -#define DBUS_TYPE_G_ARRAY_OF_STRUCTS dbus_g_type_get_collection ("GPtrArray", G_TYPE_VALUE_ARRAY); - -#define TELEPATHY_CONN_TYPE (tp_conn_get_type ()) - -#define TELEPATHY_CONN(obj) (G_TYPE_CHECK_INSTANCE_CAST \ - ((obj), TELEPATHY_CONN_TYPE, \ - TpConn)) - -#define TELEPATHY_CONN_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST \ - ((klass), TELEPATHY_CONN_TYPE, \ - TpConnClass)) - -#define TELEPATHY_IS_CONN(obj) (G_TYPE_CHECK_INSTANCE_TYPE \ - ((obj), TELEPATHY_CONN_TYPE)) - -#define TELEPATHY_IS_CONN_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE \ - ((klass), TELEPATHY_CONN_TYPE)) - -#define TELEPATHY_CONN_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS \ - ((obj), TELEPATHY_CONN_TYPE, \ - TpConnClass)) - -#define TELEPATHY_CONN_IFACE_QUARK (tp_get_conn_interface()) -#define TELEPATHY_CONN_IFACE_ALIASING_QUARK (tp_get_conn_aliasing_interface()) -#define TELEPATHY_CONN_IFACE_CAPABILITIES_QUARK (tp_get_conn_capabilities_interface()) -#define TELEPATHY_CONN_IFACE_CONTACTINFO_QUARK (tp_get_conn_contactinfo_interface()) -#define TELEPATHY_CONN_IFACE_FORWARDING_QUARK (tp_get_conn_forwarding_interface()) -#define TELEPATHY_CONN_IFACE_PRESENCE_QUARK (tp_get_conn_presence_interface()) -#define TELEPATHY_CONN_IFACE_PRIVACY_QUARK (tp_get_conn_privacy_interface()) -#define TELEPATHY_CONN_IFACE_RENAMING_QUARK (tp_get_conn_renaming_interface()) -#define TELEPATHY_CONN_IFACE_AVATAR_QUARK (tp_get_conn_avatar_interface()) - - -/* The signal name for the synthesized StatusChanged signal */ -#define TP_IFACE_CONN_SIGNAL_STATUSCHANGED_SYNTHESIZED \ - "received::org-freedesktop-Telepathy-Connection-StatusChanged" - -typedef struct _tp_conn TpConn; -typedef struct _tp_connclass TpConnClass; - -struct _tp_conn -{ - DBusGProxy parent; - GData *interface_list; - gboolean first_run; -}; - - -struct _tp_connclass -{ - DBusGProxyClass parent_class; - GData *iface_signal_sigs; -}; - -#ifdef __cplusplus -extern "C" -{ -#endif -#ifdef SYMBIAN -IMPORT_C -#endif -GType tp_conn_get_type(void); -#ifdef __cplusplus -} -#endif - -/* Actual function definitions */ - -/* - * Create a new TpConn (Connection) object. - * - * @param connection The D-BUS connection - * @param name: The D-BUS service name for the connection object - * @param path_name: The D-BUS path name for the connection object - * @param interface_name: The D-BUS interface name for the connection object - * @return A new TpConn connection object, or NULL if unsuccesful. - */ - -TpConn *tp_conn_new(DBusGConnection *connection, - const char *bus_name, - const char *object_path); - -/* Create a TpChan channel object for this connection. Also initialises - * the proxy object that is used for the actual method calls. - * - * @param connection: The DBusGConnection for the channel - * @param tpconn: The Connection object for which the channel is done - * @param bus_name: The D-Bus interface name for the channel - * @param type: The channel type string - * @param handle_type: The type of the channel handle - * @param handle: The channel handle value is set and stored here after - * @param the call returns. - * @param supress_handler: if TRUE, indicates that no handler needs to be - * launched - * - * @return A new TpChan (channel) object - */ - -#ifdef __cplusplus -extern "C" -{ -#endif -#ifdef SYMBIAN -IMPORT_C -#endif -TpChan *tp_conn_new_channel(DBusGConnection *connection, TpConn *tpconn, - const gchar *bus_name, - gchar *type, guint handle_type, - guint handle, gboolean supress_handler); -#ifdef __cplusplus -} -#endif - -/* Creates the proxy objects for the channel interfaces. GetInterfaces - * method should be called before this to acquire the interface name - * list. - * - * @param self: The connection object - * @param interfaces: An array of the interface name strings - */ - -void tp_conn_local_set_interfaces(TpConn *self, gchar **interfaces); - - -/* - * Provides access to the connection proxy object to use for actual - * method calls - * - * @param self: The connection object whose proxy should be retrieved - * @return The D-BUS proxy object - */ - -DBusGProxy *tp_conn_get_proxy(TpConn *self); - -/* - * This function checks whether the Connection has the specified - * interface and returns a proxy object that can be used to call - * its methods, if it exists. The supported interfaces are listed - * in the beginning of this header as macros. - * - * @param self The connection object that is queried for the - * interface proxy object - * @param iface_quark GQuark corresponding to the interface name - * string. - * @return A DBusGProxy object for the interface, or NULL if not found - */ -#ifdef __cplusplus -extern "C" -{ -#endif -#ifdef SYMBIAN -IMPORT_C -#endif -DBusGProxy *tp_conn_get_interface(TpConn *self, GQuark iface_quark); -#ifdef __cplusplus -} -#endif - -GQuark tp_get_conn_interface(void); -GQuark tp_get_conn_aliasing_interface(void); -GQuark tp_get_conn_capabilities_interface(void); -GQuark tp_get_conn_contactinfo_interface(void); -GQuark tp_get_conn_forwarding_interface(void); -#ifdef __cplusplus -extern "C" -{ -#endif -#ifdef SYMBIAN -IMPORT_C -#endif -GQuark tp_get_conn_presence_interface(void); -GQuark tp_get_conn_avatar_interface(void); -#ifdef __cplusplus -} -#endif -GQuark tp_get_conn_privacy_interface(void); -GQuark tp_get_conn_renaming_interface(void); - - - -#endif