构造函数

GioDBusConnectionnew_sync

since: 2.26

声明 [src]

GDBusConnection*
g_dbus_connection_new_sync (
  GIOStream* stream,
  const gchar* guid,
  GDBusConnectionFlags flags,
  GDBusAuthObserver* observer,
  GCancellable* cancellable,
  GError** error
)

描述 [src]

同步设置为与由 stream 表示的端交换 D-Bus 消息。

如果 stream 是 GSocketConnection，则相应的 GSocket 将置于非阻塞模式。

DBus 连接将与 stream 在工作线程中进行交互。因此，在调用此方法后，调用者不应与 stream 进行交互，除非调用 g_object_unref()。

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

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

自 2.26 起可用

参数

stream

类型： GIOStream

一个 GIOStream。

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

guid

类型： const gchar*

如果作为服务器进行身份验证，则使用 GUID 或 NULL。

参数可以是 NULL。

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

值是一个以空字符终止的 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() 释放。

函数的调用者接管数据，并负责释放它。