构造函数
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 地址字符串。
为了控制可用的身份验证机制和有权连接的用户,强烈建议提供非 NULL
的 GDBusAuthObserver
。
连接到 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
或NULL
。参数可以是 NULL
。数据由函数的调用者拥有。 cancellable
-
类型:
GCancellable
一个
GCancellable
或NULL
。参数可以是 NULL
。数据由函数的调用者拥有。 error
-
类型:
GError **
一个可恢复错误的返回位置。
参数可以是 NULL
。如果返回位置不是 NULL
,则必须将其初始化为NULL
的GError*
。如果没有错误,构造函数将使用 NULL
初始化参数。如果出错,参数将被设置为一个新的 GError
;调用者将拥有数据,并负责释放它。
返回值
类型: GDBusServer
一个 GDBusServer
或者在 error
设置时为 NULL
。使用 g_object_unref()
释放。
函数的调用者将拥有数据,并负责释放它。 |