gio/gdbusproxywatching.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_PROXY_WATCHING_H__
  24 #define __G_DBUS_PROXY_WATCHING_H__
  25
  26 #include <gio/giotypes.h>
  27
  28 G_BEGIN_DECLS
  29
  30 /**
  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().
  37  *
  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.
  41  *
  42  * Since: 2.26
  43  */
  44 typedef void (*GBusProxyAppearedCallback) (GDBusConnection *connection,
  45                                            const gchar     *name,
  46                                            const gchar     *name_owner,
  47                                            GDBusProxy      *proxy,
  48                                            gpointer         user_data);
  49
  50 /**
  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().
  55  *
  56  * Invoked when the proxy being watched has vanished. The #GDBusProxy
  57  * object passed in the #GBusProxyAppearedCallback callback is no
  58  * longer valid.
  59  *
  60  * Since: 2.26
  61  */
  62 typedef void (*GBusProxyVanishedCallback) (GDBusConnection *connection,
  63                                            const gchar     *name,
  64                                            gpointer         user_data);
  65
  66 guint g_bus_watch_proxy               (GBusType                   bus_type,
  67                                        const gchar               *name,
  68                                        GBusNameWatcherFlags       flags,
  69                                        const gchar               *object_path,
  70                                        const gchar               *interface_name,
  71                                        GType                      interface_type,
  72                                        GDBusProxyFlags            proxy_flags,
  73                                        GBusProxyAppearedCallback  proxy_appeared_handler,
  74                                        GBusProxyVanishedCallback  proxy_vanished_handler,
  75                                        gpointer                   user_data,
  76                                        GDestroyNotify             user_data_free_func);
  77 guint g_bus_watch_proxy_on_connection (GDBusConnection           *connection,
  78                                        const gchar               *name,
  79                                        GBusNameWatcherFlags       flags,
  80                                        const gchar               *object_path,
  81                                        const gchar               *interface_name,
  82                                        GType                      interface_type,
  83                                        GDBusProxyFlags            proxy_flags,
  84                                        GBusProxyAppearedCallback  proxy_appeared_handler,
  85                                        GBusProxyVanishedCallback  proxy_vanished_handler,
  86                                        gpointer                   user_data,
  87                                        GDestroyNotify             user_data_free_func);
  88 void  g_bus_unwatch_proxy             (guint                      watcher_id);
  89
  90 G_END_DECLS
  91
  92 #endif /* __G_DBUS_PROXY_WATCHING_H__ */