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:
GUnixFDListReturn location for a
GUnixFDListorNULL.The argument will be set by the function. The argument can be NULL.The caller of the method takes ownership of the returned data, and is responsible for freeing it. res-
Type:
GAsyncResultA
GAsyncResultobtained from theGAsyncReadyCallbackpassed to g_dbus_connection_call_with_unix_fd_list().The data is owned by the caller of the method. 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 aNULLGError*.The argument will be left initialized to NULLby 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 returned data, and is responsible for freeing it. |