方法

GioDBusConnectioncall_with_unix_fd_list_finish

since: 2.30

声明 [源码]

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

描述 [源码]

完成使用 g_dbus_connection_call_with_unix_fd_list() 开始的操作。

通常，文件描述符对应于消息体中的 G_VARIANT_TYPE_HANDLE 值。例如，如果 g_variant_get_handle() 返回 5，则它表示可以由 g_unix_fd_list_get (*out_fd_list, 5, ...) 访问的文件描述符的引用。

设计旨在实现互操作性的 D-Bus API 时，请注意，非 GDBus 实现的 D-Bus 通常只能通过以下方式访问文件描述符：在消息主体中将某个值的数据类型设置为 G_VARIANT_TYPE_HANDLE。

自 2.30 版本起可用

参数

out_fd_list

类型: GUnixFDList

GUnixFDList 的返回位置或 NULL。

该参数将由函数设置。

方法可以将其设置为零指针。

该参数可以为 NULL。

方法调用者将拥有返回的数据，并负责释放它。

res

类型: GAsyncResult

从 g_dbus_connection_call_with_unix_fd_list() 传输给 GAsyncReadyCallback 的返回 GAsyncResult。

该数据是方法调用者的拥有权。

error

类型: GError **

一个可恢复错误的返回位置。

该参数可以为 NULL。

如果返回位置不为 NULL，则必须将其初始化为零指针的 GError*。

如果没有错误，方法将初始化该参数为零指针。

如果发生错误，将设置为新分配的 GError；调用者将拥有数据，并负责释放它。

返回值

类型: GVariant

如果设置了 error，则返回 NULL。否则，将返回一个非浮动的包含返回值的 GVariant 元组。使用 g_variant_unref() 释放。

方法调用者将拥有返回的数据，并负责释放它。