1 /* GDBus - GLib D-Bus Library
3 * Copyright (C) 2008-2010 Red Hat, Inc.
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.
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.
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.
20 * Author: David Zeuthen <davidz@redhat.com>
23 #ifndef __G_DBUS_PROXY_WATCHING_H__
24 #define __G_DBUS_PROXY_WATCHING_H__
26 #include <gio/giotypes.h>
31 * GBusProxyAppearedCallback:
32 * @connection: The #GDBusConnection the proxy is being watched on.
33 * @name: The name being watched.
34 * @name_owner: Unique name of the owner of the name being watched.
35 * @proxy: A #GDBusProxy (or derived) instance with all properties loaded.
36 * @user_data: User data passed to g_bus_watch_proxy().
38 * Invoked when the proxy being watched is ready for use - the passed
39 * @proxy object is valid until the #GBusProxyVanishedCallback
40 * callback is invoked.
44 typedef void (*GBusProxyAppearedCallback) (GDBusConnection *connection,
46 const gchar *name_owner,
51 * GBusProxyVanishedCallback:
52 * @connection: The #GDBusConnection the proxy is being watched on.
53 * @name: The name being watched.
54 * @user_data: User data passed to g_bus_watch_proxy().
56 * Invoked when the proxy being watched has vanished. The #GDBusProxy
57 * object passed in the #GBusProxyAppearedCallback callback is no
62 typedef void (*GBusProxyVanishedCallback) (GDBusConnection *connection,
66 guint g_bus_watch_proxy (GBusType bus_type,
68 GBusNameWatcherFlags flags,
69 const gchar *object_path,
70 const gchar *interface_name,
72 GDBusProxyFlags proxy_flags,
73 GBusProxyAppearedCallback proxy_appeared_handler,
74 GBusProxyVanishedCallback proxy_vanished_handler,
76 GDestroyNotify user_data_free_func);
77 guint g_bus_watch_proxy_on_connection (GDBusConnection *connection,
79 GBusNameWatcherFlags flags,
80 const gchar *object_path,
81 const gchar *interface_name,
83 GDBusProxyFlags proxy_flags,
84 GBusProxyAppearedCallback proxy_appeared_handler,
85 GBusProxyVanishedCallback proxy_vanished_handler,
87 GDestroyNotify user_data_free_func);
88 void g_bus_unwatch_proxy (guint watcher_id);
92 #endif /* __G_DBUS_PROXY_WATCHING_H__ */