Add "Since: 2.30" for new D-Bus routines
[platform/upstream/glib.git] / gio / gdbusobjectmanagerclient.h
1 /* GDBus - GLib D-Bus Library
2  *
3  * Copyright (C) 2008-2010 Red Hat, Inc.
4  *
5  * This library is free software; you can redistribute it and/or
6  * modify it under the terms of the GNU Lesser General Public
7  * License as published by the Free Software Foundation; either
8  * version 2 of the License, or (at your option) any later version.
9  *
10  * This library is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13  * Lesser General Public License for more details.
14  *
15  * You should have received a copy of the GNU Lesser General
16  * Public License along with this library; if not, write to the
17  * Free Software Foundation, Inc., 59 Temple Place, Suite 330,
18  * Boston, MA 02111-1307, USA.
19  *
20  * Author: David Zeuthen <davidz@redhat.com>
21  */
22
23 #ifndef __G_DBUS_OBJECT_MANAGER_CLIENT_H__
24 #define __G_DBUS_OBJECT_MANAGER_CLIENT_H__
25
26 #include <gio/giotypes.h>
27
28 G_BEGIN_DECLS
29
30 #define G_TYPE_DBUS_OBJECT_MANAGER_CLIENT         (g_dbus_object_manager_client_get_type ())
31 #define G_DBUS_OBJECT_MANAGER_CLIENT(o)           (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_DBUS_OBJECT_MANAGER_CLIENT, GDBusObjectManagerClient))
32 #define G_DBUS_OBJECT_MANAGER_CLIENT_CLASS(k)     (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_DBUS_OBJECT_MANAGER_CLIENT, GDBusObjectManagerClientClass))
33 #define G_DBUS_OBJECT_MANAGER_CLIENT_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_DBUS_OBJECT_MANAGER_CLIENT, GDBusObjectManagerClientClass))
34 #define G_IS_DBUS_OBJECT_MANAGER_CLIENT(o)        (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_DBUS_OBJECT_MANAGER_CLIENT))
35 #define G_IS_DBUS_OBJECT_MANAGER_CLIENT_CLASS(k)  (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_DBUS_OBJECT_MANAGER_CLIENT))
36
37 typedef struct _GDBusObjectManagerClientClass   GDBusObjectManagerClientClass;
38 typedef struct _GDBusObjectManagerClientPrivate GDBusObjectManagerClientPrivate;
39
40 /**
41  * GDBusObjectManagerClient:
42   *
43  * The #GDBusObjectManagerClient structure contains private data and should
44  * only be accessed using the provided API.
45  *
46  * Since: 2.30
47  */
48 struct _GDBusObjectManagerClient
49 {
50   /*< private >*/
51   GObject parent_instance;
52   GDBusObjectManagerClientPrivate *priv;
53 };
54
55 /**
56  * GDBusObjectManagerClientClass:
57  * @parent_class: The parent class.
58  * @interface_proxy_signal: Signal class handler for the #GDBusObjectManagerClient::interface-proxy-signal signal.
59  * @interface_proxy_properties_changed: Signal class handler for the #GDBusObjectManagerClient::interface-proxy-properties-changed signal.
60  *
61  * Class structure for #GDBusObjectManagerClient.
62  *
63  * Since: 2.30
64  */
65 struct _GDBusObjectManagerClientClass
66 {
67   GObjectClass parent_class;
68
69   /* signals */
70   void    (*interface_proxy_signal)             (GDBusObjectManagerClient *manager,
71                                                  GDBusObjectProxy         *object_proxy,
72                                                  GDBusProxy               *interface_proxy,
73                                                  const gchar              *sender_name,
74                                                  const gchar              *signal_name,
75                                                  GVariant                 *parameters);
76
77   void    (*interface_proxy_properties_changed) (GDBusObjectManagerClient   *manager,
78                                                  GDBusObjectProxy           *object_proxy,
79                                                  GDBusProxy                 *interface_proxy,
80                                                  GVariant                   *changed_properties,
81                                                  const gchar* const         *invalidated_properties);
82
83   /*< private >*/
84   gpointer padding[8];
85 };
86
87 GType                         g_dbus_object_manager_client_get_type           (void) G_GNUC_CONST;
88 void                          g_dbus_object_manager_client_new                (GDBusConnection               *connection,
89                                                                                GDBusObjectManagerClientFlags  flags,
90                                                                                const gchar                   *name,
91                                                                                const gchar                   *object_path,
92                                                                                GDBusProxyTypeFunc             get_proxy_type_func,
93                                                                                gpointer                       get_proxy_type_user_data,
94                                                                                GCancellable                  *cancellable,
95                                                                                GAsyncReadyCallback            callback,
96                                                                                gpointer                       user_data);
97 GDBusObjectManager           *g_dbus_object_manager_client_new_finish         (GAsyncResult                  *res,
98                                                                                GError                       **error);
99 GDBusObjectManager           *g_dbus_object_manager_client_new_sync           (GDBusConnection               *connection,
100                                                                                GDBusObjectManagerClientFlags  flags,
101                                                                                const gchar                   *name,
102                                                                                const gchar                   *object_path,
103                                                                                GDBusProxyTypeFunc             get_proxy_type_func,
104                                                                                gpointer                       get_proxy_type_user_data,
105                                                                                GCancellable                  *cancellable,
106                                                                                GError                       **error);
107 void                          g_dbus_object_manager_client_new_for_bus        (GBusType                       bus_type,
108                                                                                GDBusObjectManagerClientFlags  flags,
109                                                                                const gchar                   *name,
110                                                                                const gchar                   *object_path,
111                                                                                GDBusProxyTypeFunc             get_proxy_type_func,
112                                                                                gpointer                       get_proxy_type_user_data,
113                                                                                GCancellable                  *cancellable,
114                                                                                GAsyncReadyCallback            callback,
115                                                                                gpointer                       user_data);
116 GDBusObjectManager           *g_dbus_object_manager_client_new_for_bus_finish (GAsyncResult                  *res,
117                                                                                GError                       **error);
118 GDBusObjectManager           *g_dbus_object_manager_client_new_for_bus_sync   (GBusType                       bus_type,
119                                                                                GDBusObjectManagerClientFlags  flags,
120                                                                                const gchar                   *name,
121                                                                                const gchar                   *object_path,
122                                                                                GDBusProxyTypeFunc             get_proxy_type_func,
123                                                                                gpointer                       get_proxy_type_user_data,
124                                                                                GCancellable                  *cancellable,
125                                                                                GError                       **error);
126 GDBusConnection              *g_dbus_object_manager_client_get_connection     (GDBusObjectManagerClient      *manager);
127 GDBusObjectManagerClientFlags g_dbus_object_manager_client_get_flags          (GDBusObjectManagerClient      *manager);
128 const gchar                  *g_dbus_object_manager_client_get_name           (GDBusObjectManagerClient      *manager);
129 gchar                        *g_dbus_object_manager_client_get_name_owner     (GDBusObjectManagerClient      *manager);
130
131 G_END_DECLS
132
133 #endif /* __G_DBUS_OBJECT_MANAGER_CLIENT_H */