luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-03-03 22:52:09 +01:00
Code Issues Packages Projects Releases Wiki Activity

Bug 624483: GDBusSubtreeEnumerateFunc clarification

Browse Source 
Clarify a couple of things in the docs:

  1) you must return flat names (no slashes)

  2) g_strfreev() will be called on the result

  3) a benefit of using the DISPATCH_TO_UNENUMERATED flag
This commit is contained in:
Ryan Lortie 2010-07-15 16:47:32 -04:00
parent e6b5546cf5
commit ca14ab7ac0
1 changed files with 10 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
gio/gdbusconnection.h
View File

@ -306,6 +306,16 @@ gboolean g_dbus_connection_unregister_object (GDBusConnection
* *
* The type of the @enumerate function in #GDBusSubtreeVTable. * The type of the @enumerate function in #GDBusSubtreeVTable.
* *
* This function is called when generating introspection data and also
* when preparing to dispatch incoming messages in the event that the
* %G_DBUS_SUBTREE_FLAGS_DISPATCH_TO_UNENUMERATED_NODES flag is not
* specified (ie: to verify that the object path is valid).
*
* Hierarchies are not supported; the items that you return should not
* contain the '/' character.
*
* The return value will be freed with g_strfreev().
*
* Returns: A newly allocated array of strings for node names that are children of @object_path. * Returns: A newly allocated array of strings for node names that are children of @object_path.
* *
* Since: 2.26 * Since: 2.26