util_unwrap_dbus_error

Description:

[ Version ( deprecated = true , deprecated_since = "3.8" , since = "3.2" ) ]
public static bool util_unwrap_dbus_error (Error dbus_error, out Error client_error, ClientErrorsList known_errors, uint known_errors_count, Quark known_errors_domain, bool fail_when_none_matched)

Warning: util_unwrap_dbus_error is deprecated since 3.8.

The function takes a dbus_error and tries to find a match in known_errors for it, if it is a G_IO_ERROR, G_IO_ERROR_DBUS_ERROR.

Note:

This function is no longer used.

If it is anything else then the dbus_error is moved to client_error.

The fail_when_none_matched influences behaviour. If it's true, and none of known_errors matches, or this is not a G_IO_ERROR_DBUS_ERROR, then false is returned and the client_error is left without change. Otherwise, the fail_when_none_matched is false , the error is always processed and will result in E_CLIENT_ERROR, E_CLIENT_ERROR_OTHER_ERROR if none of known_error matches.

Parameters:

dbus_error	DBus Error to unwrap
client_error	Resulting Error; can be null
known_errors	List of known errors against which try to match
known_errors_count	How many items are stored in `known_errors`
known_errors_domain	Error domain for `known_errors`
fail_when_none_matched	Whether to fail when none of `known_errors` matches

Returns:

Whether was dbus_error processed into client_error.

Note: The dbus_error is automatically freed if returned true.