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

Docs: explain what a NULL vtable might be good for

Browse Source 
https://bugzilla.gnome.org/show_bug.cgi?id=646419
This commit is contained in:
Matthias Clasen 2011-04-01 13:44:23 -04:00
parent 770442f2de
commit 471498c621
1 changed files with 13 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
gio/gdbusconnection.c
View File

@ -4624,13 +4624,13 @@ obj_message_func (GDBusConnection *connection,
/**
* g_dbus_connection_register_object:
* @connection: A #GDBusConnection.
* @object_path: The object path to register at.
* @interface_info: Introspection data for the interface.
* @vtable: A #GDBusInterfaceVTable to call into or %NULL.
* @user_data: Data to pass to functions in @vtable.
* @user_data_free_func: Function to call when the object path is unregistered.
* @error: Return location for error or %NULL.
* @connection: A #GDBusConnection
* @object_path: The object path to register at
* @interface_info: Introspection data for the interface
* @vtable: A #GDBusInterfaceVTable to call into, or %NULL
* @user_data: Data to pass to functions in @vtable
* @user_data_free_func: Function to call when the object path is unregistered
* @error: Return location for error or %NULL
*
* Registers callbacks for exported objects at @object_path with the
* D-Bus interface that is described in @interface_info.
@ -4669,7 +4669,12 @@ obj_message_func (GDBusConnection *connection,
* reference count is -1, see g_dbus_interface_info_ref()) for as long
* as the object is exported. Also note that @vtable will be copied.
*
* See <xref linkend="gdbus-server"/> for an example of how to use this method.
* A %NULL @vtable can be used for
* <ulink url="http://en.wikipedia.org/wiki/Marker_interface_pattern">marker
* interfaces</ulink>.
*
* See <xref linkend="gdbus-server"/> for an example of how to use this
* method.
*
* Returns: 0 if @error is set, otherwise a registration id (never 0)
* that can be used with g_dbus_connection_unregister_object() .