方法

GioDBusConnectioncall_with_unix_fd_list_sync

自：2.30

声明 [源]

GVariant*
g_dbus_connection_call_with_unix_fd_list_sync (
  GDBusConnection* connection,
  const gchar* bus_name,
  const gchar* object_path,
  const gchar* interface_name,
  const gchar* method_name,
  GVariant* parameters,
  const GVariantType* reply_type,
  GDBusCallFlags flags,
  gint timeout_msec,
  GUnixFDList* fd_list,
  GUnixFDList** out_fd_list,
  GCancellable* cancellable,
  GError** error
)

描述 [源]

类似于 g_dbus_connection_call_sync()，但还接收和返回 GUnixFDList 对象。参见 g_dbus_connection_call_with_unix_fd_list() 和 g_dbus_connection_call_with_unix_fd_list_finish() 获取更多信息。

此方法仅在 UNIX 上可用。

自：2.30

参数

bus_name

类型： const gchar*

一个唯一的或众所周知的服务名，或者 NULL 如果 connection 不是消息总线连接。

该参数可以是 NULL。
数据由方法调用者拥有。
该值是一个以空字符终止的 UTF-8 字符串。
object_path

类型： const gchar*

远程对象路径。

数据由方法调用者拥有。
该值是一个以空字符终止的 UTF-8 字符串。
interface_name

类型： const gchar*

要在其上调用方法的 D-Bus 接口。

数据由方法调用者拥有。
该值是一个以空字符终止的 UTF-8 字符串。
method_name

类型： const gchar*

要调用的方法名。

数据由方法调用者拥有。
该值是一个以空字符终止的 UTF-8 字符串。
parameters

类型： GVariant

一个带参数的方法 GVariant 元组或 NULL 如果不传递参数。

该参数可以是 NULL。
数据由方法调用者拥有。
回复类型

类型: GVariantType

预期的回复类型，或 NULL。

该参数可以是 NULL。
数据由方法调用者拥有。
标志

类型: GDBusCallFlags

来自 GDBusCallFlags 枚举的标志。

timeout_msec

类型: gint

超时时间（毫秒），-1 使用默认超时或 G_MAXINT 表示没有超时。

fd_list

类型: GUnixFDList

GUnixFDList 或 NULL。

该参数可以是 NULL。
数据由方法调用者拥有。
out_fd_list

类型: GUnixFDList

返回一个 GUnixFDList 或 NULL 的位置。

该参数将由函数设置。
方法可以将其设置为 NULL。
该参数可以是 NULL。
方法的调用者将拥有返回的数据，并负责释放它。
cancellable

类型: GCancellable

GCancellable 或 NULL。

该参数可以是 NULL。
数据由方法调用者拥有。
error

类型: GError **

恢复错误的位置。

该参数可以是 NULL。
如果返回位置不是 NULL，则必须将其初始化为 NULL GError。
如果没有错误，方法将初始化参数为 NULL。
出错时，参数将被设置为一个新的 GError；调用者将接管数据，并负责释放它。

返回值

类型： GVariant

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

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