luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2024-11-10 03:16:17 +01:00
Code Issues Packages Projects Releases Wiki Activity

GDBusMethodInvocation: Clarify how the ownership is handled

Browse Source 
https://bugzilla.gnome.org/show_bug.cgi?id=767952
This commit is contained in:
Debarshi Ray 2016-06-23 11:05:56 +02:00
parent 578b42a2f2
commit 00bf553a60
1 changed files with 24 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
gio/gdbusmethodinvocation.c
View File

@ -536,7 +536,9 @@ g_dbus_method_invocation_return_value_internal (GDBusMethodInvocation *invocatio
* *
* It is an error if @parameters is not of the right format. * It is an error if @parameters is not of the right format.
* *
* This method will free @invocation, you cannot use it afterwards. * This method will take ownership of @invocation. See
* #GDBusInterfaceVTable for more information about the ownership of
* @invocation.
* *
* Since 2.48, if the method call requested for a reply not to be sent * Since 2.48, if the method call requested for a reply not to be sent
* then this call will sink @parameters and free @invocation, but * then this call will sink @parameters and free @invocation, but
@ -563,7 +565,9 @@ g_dbus_method_invocation_return_value (GDBusMethodInvocation *invocation,
* *
* This method is only available on UNIX. * This method is only available on UNIX.
* *
* This method will free @invocation, you cannot use it afterwards. * This method will take ownership of @invocation. See
* #GDBusInterfaceVTable for more information about the ownership of
* @invocation.
* *
* Since: 2.30 * Since: 2.30
*/ */
@ -599,7 +603,9 @@ g_dbus_method_invocation_return_value_with_unix_fd_list (GDBusMethodInvocation *
* always register errors with g_dbus_error_register_error() * always register errors with g_dbus_error_register_error()
* or use g_dbus_method_invocation_return_dbus_error(). * or use g_dbus_method_invocation_return_dbus_error().
* *
* This method will free @invocation, you cannot use it afterwards. * This method will take ownership of @invocation. See
* #GDBusInterfaceVTable for more information about the ownership of
* @invocation.
* *
* Since 2.48, if the method call requested for a reply not to be sent * Since 2.48, if the method call requested for a reply not to be sent
* then this call will free @invocation but otherwise do nothing (as per * then this call will free @invocation but otherwise do nothing (as per
@ -639,7 +645,9 @@ g_dbus_method_invocation_return_error (GDBusMethodInvocation *invocation,
* Like g_dbus_method_invocation_return_error() but intended for * Like g_dbus_method_invocation_return_error() but intended for
* language bindings. * language bindings.
* *
* This method will free @invocation, you cannot use it afterwards. * This method will take ownership of @invocation. See
* #GDBusInterfaceVTable for more information about the ownership of
* @invocation.
* *
* Since: 2.26 * Since: 2.26
*/ */
@ -672,7 +680,9 @@ g_dbus_method_invocation_return_error_valist (GDBusMethodInvocation *invocation,
* *
* Like g_dbus_method_invocation_return_error() but without printf()-style formatting. * Like g_dbus_method_invocation_return_error() but without printf()-style formatting.
* *
* This method will free @invocation, you cannot use it afterwards. * This method will take ownership of @invocation. See
* #GDBusInterfaceVTable for more information about the ownership of
* @invocation.
* *
* Since: 2.26 * Since: 2.26
*/ */
@ -700,7 +710,9 @@ g_dbus_method_invocation_return_error_literal (GDBusMethodInvocation *invocation
* Like g_dbus_method_invocation_return_error() but takes a #GError * Like g_dbus_method_invocation_return_error() but takes a #GError
* instead of the error domain, error code and message. * instead of the error domain, error code and message.
* *
* This method will free @invocation, you cannot use it afterwards. * This method will take ownership of @invocation. See
* #GDBusInterfaceVTable for more information about the ownership of
* @invocation.
* *
* Since: 2.26 * Since: 2.26
*/ */
@ -729,7 +741,9 @@ g_dbus_method_invocation_return_gerror (GDBusMethodInvocation *invocation,
* Like g_dbus_method_invocation_return_gerror() but takes ownership * Like g_dbus_method_invocation_return_gerror() but takes ownership
* of @error so the caller does not need to free it. * of @error so the caller does not need to free it.
* *
* This method will free @invocation, you cannot use it afterwards. * This method will take ownership of @invocation. See
* #GDBusInterfaceVTable for more information about the ownership of
* @invocation.
* *
* Since: 2.30 * Since: 2.30
*/ */
@ -751,7 +765,9 @@ g_dbus_method_invocation_take_error (GDBusMethodInvocation *invocation,
* *
* Finishes handling a D-Bus method call by returning an error. * Finishes handling a D-Bus method call by returning an error.
* *
* This method will free @invocation, you cannot use it afterwards. * This method will take ownership of @invocation. See
* #GDBusInterfaceVTable for more information about the ownership of
* @invocation.
* *
* Since: 2.26 * Since: 2.26
*/ */