函数

Giobus_get_sync

自：2.26

声明 [源代码]

GDBusConnection*
g_bus_get_sync (
  GBusType bus_type,
  GCancellable* cancellable,
  GError** error
)

描述 [源代码]

以同步方式连接到由bus_type指定的消息总线。注意，返回的对象可能与其他调用者共享，例如，如果进程的两个不同部分使用相同的bus_type调用此函数，它们将共享相同的对象。

这是一个同步且可能失败的函数。有关异步版本，请参阅g_bus_get()和g_bus_get_finish()。

返回的对象是单例的，即与其他调用g_bus_get()和g_bus_get_sync()的bus_type的调用者共享。如果您需要私有消息总线连接，请使用带有G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_CLIENT和G_DBUS_CONNECTION_FLAGS_MESSAGE_BUS_CONNECTION标志的g_dbus_address_get_for_bus_sync()和g_dbus_connection_new_for_address()。

注意，返回的GDBusConnection对象通常将GDBusConnection:exit-on-close属性设置为TRUE。

自可用：2.26

参数

bus_type

类型： GBusType

一个GBusType。

cancellable

类型： GCancellable

GCancellable或NULL。

该参数可以是NULL。

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

error

类型： GError **

用于可恢复错误的返回位置。

该参数可以是NULL。

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

如果没有错误，该函数将使参数留置为NULL。

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

返回值

类型： GDBusConnection

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

函数的调用者拥有数据，并负责释放它。