方法

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,则必须将其初始化为 NULLGError*
如果没有错误,方法将保留参数初始化为 NULL
在出错情况下,参数将被设置为新的 GError;调用者将拥有数据所有权,并负责释放它。

返回值

类型: guint

导出的 ID(从不为零),或者在失败的情况下为 0。