luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-02-26 12:12:10 +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.
*
* 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
* 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 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
*/
@ -599,7 +603,9 @@ g_dbus_method_invocation_return_value_with_unix_fd_list (GDBusMethodInvocation *
* always register errors with g_dbus_error_register_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
* 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
* 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
*/
@ -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.
*
* 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
*/
@ -700,7 +710,9 @@ g_dbus_method_invocation_return_error_literal (GDBusMethodInvocation *invocation
* Like g_dbus_method_invocation_return_error() but takes a #GError
* 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
*/
@ -729,7 +741,9 @@ g_dbus_method_invocation_return_gerror (GDBusMethodInvocation *invocation,
* Like g_dbus_method_invocation_return_gerror() but takes ownership
* 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
*/
@ -751,7 +765,9 @@ g_dbus_method_invocation_take_error (GDBusMethodInvocation *invocation,
*
* 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
*/