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