Method

GioDBusConnectioncall_with_unix_fd_list_finish

since: 2.30

Declaration [src]

GVariant*
g_dbus_connection_call_with_unix_fd_list_finish (
  GDBusConnection* connection,
  GUnixFDList** out_fd_list,
  GAsyncResult* res,
  GError** error
)

Description [src]

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 or NULL.

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 the GAsyncReadyCallback passed to g_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 a NULL 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.