Function

Giobus_watch_name_on_connection

Declaration [src]

guint
g_bus_watch_name_on_connection (
  GDBusConnection* connection,
  const gchar* name,
  GBusNameWatcherFlags flags,
  GBusNameAppearedCallback name_appeared_handler,
  GBusNameVanishedCallback name_vanished_handler,
  gpointer user_data,
  GDestroyNotify user_data_free_func
)

Description [src]

Like g_bus_watch_name() but takes a GDBusConnection instead of a GBusType.

Available since:2.26

Parameters

connection GDBusConnection
 

A GDBusConnection.

 The data is owned by the caller of the function.
name const gchar*
 

The name (well-known or unique) to watch.

 The data is owned by the caller of the function.
 The string is a NUL terminated UTF-8 string.
flags GBusNameWatcherFlags
 

Flags from the GBusNameWatcherFlags enumeration.

name_appeared_handler GBusNameAppearedCallback
 

Handler to invoke when name is known to exist or NULL.

name_vanished_handler GBusNameVanishedCallback
 

Handler to invoke when name is known to not exist or NULL.

user_data gpointer
 

User data to pass to handlers.

user_data_free_func GDestroyNotify
 

Function for freeing user_data or NULL.

Return value

Returns: guint
 

An identifier (never 0) that can be used with g_bus_unwatch_name() to stop watching the name.