方法

GioDBusMethodInvocationreturn_error

自：2.26

声明 [src]

void
g_dbus_method_invocation_return_error (
  GDBusMethodInvocation* invocation,
  GQuark domain,
  gint code,
  const gchar* format,
  ...
)

描述 [src]

通过返回错误的方式完成对 D-Bus 方法调用的处理。

有关在网络上返回的错误名称的详细信息，请参阅 g_dbus_error_encode_gerror()。简而言之，如果使用 g_dbus_error_register_error() 注册了提供的错误，则使用注册时给出的名称。否则，使用形如 org.gtk.GDBus.UnmappedGError.Quark... 的名称。这为 GDBus 使用者之间提供了透明的 GError 映射。

如果您正在编写一个打算可移植的应用程序，则始终使用 g_dbus_error_register_error() 或 g_dbus_method_invocation_return_dbus_error() 来注册错误。

此方法将获得对 invocation 的所有权。有关 invocation 所有权方面的更多信息，请参阅 GDBusInterfaceVTable。

自 2.48 以来，如果方法调用请求不发送回复，则此调用将释放 invocation，否则不执行任何操作（按照 D-Bus 规范的建议）。

自：2.26

此方法对语言绑定不可直接访问。

参数

域

类型: GQuark

GError 错误域的 GQuark。

代码

类型: gint

错误代码。

格式

类型: const gchar*

Printf() 样式的格式。

数据由方法调用者拥有。

值是一个以 NULL 结尾的 UTF-8 字符串。

...

类型:

为 format 提供的参数。