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: * g_dbus_connection_register_object:
* @connection: A #GDBusConnection. * @connection: A #GDBusConnection
* @object_path: The object path to register at. * @object_path: The object path to register at
* @interface_info: Introspection data for the interface. * @interface_info: Introspection data for the interface
* @vtable: A #GDBusInterfaceVTable to call into or %NULL. * @vtable: A #GDBusInterfaceVTable to call into, or %NULL
* @user_data: Data to pass to functions in @vtable. * @user_data: Data to pass to functions in @vtable
* @user_data_free_func: Function to call when the object path is unregistered. * @user_data_free_func: Function to call when the object path is unregistered
* @error: Return location for error or %NULL. * @error: Return location for error or %NULL
* *
* Registers callbacks for exported objects at @object_path with the * Registers callbacks for exported objects at @object_path with the
* D-Bus interface that is described in @interface_info. * 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 * 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. * 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) * Returns: 0 if @error is set, otherwise a registration id (never 0)
* that can be used with g_dbus_connection_unregister_object() . * that can be used with g_dbus_connection_unregister_object() .