Method
GioDBusConnectioncall_with_unix_fd_list_finish
since: 2.30
Declaration
GVariant*
g_dbus_connection_call_with_unix_fd_list_finish (
GDBusConnection* connection,
GUnixFDList** out_fd_list,
GAsyncResult* res,
GError** error
)
Description
Finishes an operation started with g_dbus_connection_call_with_unix_fd_list().
The file descriptors normally correspond to G_VARIANT_TYPE_HANDLE
values in the body of the message. For example,
if g_variant_get_handle()
returns 5, that is intended to be a reference
to the file descriptor that can be accessed by
g_unix_fd_list_get (*out_fd_list, 5, ...)
.
When designing D-Bus APIs that are intended to be interoperable,
please note that non-GDBus implementations of D-Bus can usually only
access file descriptors if they are referenced in this way by a
value of type G_VARIANT_TYPE_HANDLE
in the body of the message.
Available since: 2.30
Parameters
out_fd_list
-
Type:
GUnixFDList
Return location for a
GUnixFDList
orNULL
.The argument will be set by the function. The argument can be NULL
.The instance takes ownership of the data, and is responsible for freeing it. res
-
Type:
GAsyncResult
A
GAsyncResult
obtained from theGAsyncReadyCallback
passed tog_dbus_connection_call_with_unix_fd_list()
The data is owned by the caller of the function. error
-
Type:
GError **
The return location for a recoverable error.
The argument can be NULL
.If the return location is not NULL
, then you must initialize it to aNULL
GError*
.The argument will left initialized to NULL
by the method if there are no errors.In case of error, the argument will be set to a newly allocated GError
; the caller will take ownership of the data, and be responsible for freeing it.
Return value
Type: GVariant
NULL
if error
is set. Otherwise a non-floating
GVariant
tuple with return values. Free with g_variant_unref().
The caller of the method takes ownership of the data, and is responsible for freeing it. |