函数

GioDBusConnectionnew_for_address

since: 2.26

声明 [src]

void
g_dbus_connection_new_for_address (
  const gchar* address,
  GDBusConnectionFlags flags,
  GDBusAuthObserver* observer,
  GCancellable* cancellable,
  GAsyncReadyCallback callback,
  gpointer user_data
)

描述 [src]

以异步方式连接并设置 D-Bus 客户端连接，用于交换与由 address 指定的端点（该地址必须是 D-Bus 地址格式）的 D-Bus 消息。

此构造函数只能用于发起客户端连接 - 如果需要作为服务器，请使用 g_dbus_connection_new()。特别是，flags 不能包含 G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER、G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_ALLOW_ANONYMOUS 或 G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_REQUIRE_SAME_USER 标志。

操作完成后，将调用 callback。然后您可以调用 g_dbus_connection_new_for_address_finish() 来获取操作的结果。

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

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

可用以来自：2.26

此函数是异步完成的。请在 GAsyncReadyCallback 中使用 g_dbus_connection_new_for_address_finish() 来获取操作的结果。

参数

address

类型： const gchar*

一个 D-Bus 地址。

数据由函数的调用者拥有。
值是一个以 NUL 结尾的 UTF-8 字符串。
flags

类型： GDBusConnectionFlags

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

observer

类型： GDBusAuthObserver

一个 GDBusAuthObserver 或 NULL。

参数可以 NULL。
数据由函数的调用者拥有。
cancellable

类型： GCancellable

一个 GCancellable 或 NULL。

参数可以 NULL。
数据由函数的调用者拥有。
callback

类型： GAsyncReadyCallback

当请求得到满足时调用的 GAsyncReadyCallback。

user_data

类型： gpointer

要传递给 callback 的数据。

参数可以 NULL。
数据由函数的调用者拥有。