方法
GioDBusConnectionexport_action_group
since: 2.32
声明 [源]
guint
g_dbus_connection_export_action_group (
GDBusConnection* connection,
const gchar* object_path,
GActionGroup* action_group,
GError** error
)
描述 [源]
在连接的 object_path
上导出 action_group
。
实现的 D-Bus API 应视为私有。它可能会在未来更改。
给定的对象路径只能导出一个操作组。如果违反此约束,则导出将失败并返回 0(同时根据 error
设置相应的值)。
您可以使用 g_dbus_connection_unexport_action_group()
与这个函数的返回值取消导出操作组。
调用此函数时,使用线程默认的主上下文。所有传入的操作激活和状态更改请求都从此上下文报告。必须也从同一个上下文发出导致操作组发出信号的任何更改。由于操作激活和状态更改请求很可能导致操作组的更改,因此这实际上限制了给定的操作组只从单一主上下文中导出。
自版本:2.32起可用
参数
object_path
-
类型:
const gchar*
一个 D-Bus 对象路径。
数据由方法调用者拥有。 该值是一个以 NUL 结尾的 UTF-8 字符串。 action_group
-
类型:
GActionGroup
一个操作组。
数据由方法调用者拥有。 error
-
类型:
GError **
可恢复错误的返回位置。
该参数可以是 NULL
。如果返回位置不是 NULL
,则必须将其初始化为NULL
的GError*
。如果没有错误,方法将保留参数初始化为 NULL
。在出错情况下,参数将被设置为新的 GError
;调用者将拥有数据所有权,并负责释放它。