libtelepathy/inc/tp-conn.h
changeset 10 59927b2d3b75
parent 0 d0f3a028347a
--- 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 <dbus/dbus-glib.h>
-
-#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