构造函数

GioDBusServernew_sync

自 2.26 起有效

声明 [源代码]

GDBusServer*
g_dbus_server_new_sync (
  const gchar* address,
  GDBusServerFlags flags,
  const gchar* guid,
  GDBusAuthObserver* observer,
  GCancellable* cancellable,
  GError** error
)

描述 [源代码]

创建一个新的 D-Bus 服务器,该服务器监听地址列表中第一个可用的地址。

构造完毕后,您可以使用 g_dbus_server_get_client_address() 获取一个客户端可以用来连接的 D-Bus 地址字符串。

为了控制可用的身份验证机制和有权连接的用户,强烈建议提供非 NULLGDBusAuthObserver

连接到 GDBusServer::new-connection 信号以处理传入的连接。

返回的 GDBusServer 不是活动的 - 您必须使用 g_dbus_server_start() 启动它。

GDBusServer 在此 [示例][gdbus-peer-to-peer] 中使用。

这是一个同步的可失败构造函数。目前没有异步版本。

自 2.26 起有效

参数

address

类型: const gchar*

一个 D-Bus 地址。

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

类型: GDBusServerFlags

GDBusServerFlags 枚举的标志。

guid

类型: const gchar*

D-Bus GUID

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

类型: GDBusAuthObserver

一个 GDBusAuthObserverNULL

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

类型: GCancellable

一个 GCancellableNULL

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

类型: GError **

一个可恢复错误的返回位置。

参数可以是 NULL
如果返回位置不是 NULL,则必须将其初始化为 NULLGError*
如果没有错误,构造函数将使用 NULL 初始化参数。
如果出错,参数将被设置为一个新的 GError;调用者将拥有数据,并负责释放它。

返回值

类型: GDBusServer

一个 GDBusServer 或者在 error 设置时为 NULL。使用 g_object_unref() 释放。

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