构造函数

GioDBusConnectionnew_for_address_sync

自版本：2.26

声明 [源代码]

GDBusConnection*
g_dbus_connection_new_for_address_sync (
  const gchar* address,
  GDBusConnectionFlags flags,
  GDBusAuthObserver* observer,
  GCancellable* cancellable,
  GError** error
)

描述 [源代码]

同步连接并设置DBus客户端连接，用于与通过address指定的端点交换DBus消息。其中address必须遵循DBus地址格式。

此构造函数只能用于初始化客户端连接 - 如需作为服务器操作，请使用g_dbus_connection_new_sync()。特别是，flags不能包含G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER、G_DBUS_CONNECTION_FLAGS_AUTHENTICATION-Allow_ANONYMOUS或G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_REQUIRE_SAME_USER标志。

这是一个同步的可能会失败的构造函数。有关异步版本，请参阅g_dbus_connection_new_for_address()。

如果observer不为NULL，则可以使用它来控制身份验证过程。

自版本：2.26

参数

address

类型： const gchar*

DBus地址。

数据由函数的调用者拥有。

值是一个以空字符终止的UTF-8字符串。

flags

类型： GDBusConnectionFlags

描述如何建立连接的标志。

observer

类型： GDBusAuthObserver

GDBusAuthObserver 或 NULL。

参数可以是 NULL。

数据由函数的调用者拥有。

cancellable

类型： GCancellable

GCancellable 或 NULL。

参数可以是 NULL。

数据由函数的调用者拥有。

error

类型： GError **

恢复错误的返回位置。

参数可以是 NULL。

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

如果没有任何错误，构造函数将保留参数为NULL。

如果发生错误，将参数设置为新的GError；调用者将获取数据的所有权，并负责释放它。

返回值

类型： GDBusConnection

一个 GDBusConnection，如果 error设置了则为NULL。使用g_object_unref()释放。

函数的调用者将获取数据的所有权，并负责释放它。