DBusSubtreeIntrospectFunc


Description:

public delegate DBusInterfaceInfo DBusSubtreeIntrospectFunc (DBusConnection connection, string sender, string object_path, string node)

The type of the introspect function in DBusSubtreeVTable.

Subtrees are flat. node, if non-null, is always exactly one segment of the object path (ie: it never contains a slash).

This function should return null to indicate that there is no object at this node.

If this function returns non-null, the return value is expected to be a null-terminated array of pointers to DBusInterfaceInfo structures describing the interfaces implemented by node. This array will have unref called on each item before being freed with g_free.

The difference between returning null and an array containing zero items is that the standard DBus interfaces will returned to the remote introspector in the empty array case, but not in the null case.

Parameters:

connection

A DBusConnection.

sender

The unique bus name of the remote caller.

object_path

The object path that was registered with register_subtree.

node

A node that is a child of object_path (relative to object_path) or null for the root of the subtree.

user_data

The user_data gpointer passed to register_subtree.

Returns:

A null-terminated array of pointers to DBusInterfaceInfo, or null.


Namespace: GLib
Package: gio-2.0