方法

GioDBusConnectionemit_signal

自:2.26

声明 [src]

gboolean
g_dbus_connection_emit_signal (
  GDBusConnection* connection,
  const gchar* destination_bus_name,
  const gchar* object_path,
  const gchar* interface_name,
  const gchar* signal_name,
  GVariant* parameters,
  GError** error
)

描述 [src]

发送一个信号。

如果GVariant参数是浮动的,它将被消耗。

此操作只有在参数parameters不兼容D-Bus协议(G_IO_ERROR_INVALID_ARGUMENT)或连接connection已关闭(G_IO_ERROR_CLOSED)时才会失败。

自:2.26以来

参数

destination_bus_name

类型: const gchar*

接收信号的信号的目标的唯一总线名称或NULL以向所有听众发送。

该参数可以是NULL
该数据由方法的调用者所有。
该值是一个以NUL结尾的UTF-8字符串。
object_path

类型: const gchar*

远程对象的路径。

该数据由方法的调用者所有。
该值是一个以NUL结尾的UTF-8字符串。
interface_name

类型: const gchar*

要发射信号的DBus接口。

该数据由方法的调用者所有。
该值是一个以NUL结尾的UTF-8字符串。
signal_name

类型: const gchar*

要发射的信号名称。

该数据由方法的调用者所有。
该值是一个以NUL结尾的UTF-8字符串。
parameters

类型: GVariant

一个包含信号或未传递参数时为NULL的参数的GVariant元组。

该参数可以是NULL
该数据由方法的调用者所有。
error

类型: GError **

恢复性错误的返回位置。

该参数可以是NULL
如果返回位置不为NULL,则必须将其初始化为NULLGError*
如果没有错误,该方法将参数初始化为NULL
发生错误时,参数将设置为一个新的分配的GError;调用者将拥有数据,并负责释放它。

返回值

类型: gboolean

除非error被设置,否则为TRUE