方法
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
,则必须将其初始化为NULL
的GError*
。如果没有错误,该方法将参数初始化为 NULL
。发生错误时,参数将设置为一个新的分配的 GError
;调用者将拥有数据,并负责释放它。