构造函数
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-
类型:
GDBusServerFlagsGDBusServerFlags枚举的标志。 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() 释放。
| 函数的调用者将拥有数据,并负责释放它。 |