QDBusError¶

PyQt5.QtDBus.QDBusError

Description¶

The QDBusError class represents an error received from the D-Bus bus or from remote applications found in the bus.

When dealing with the D-Bus bus service or with remote applications over D-Bus, a number of error conditions can happen. This error conditions are sometimes signalled by a returned error value or by a QDBusError.

C++ and Java exceptions are a valid analogy for D-Bus errors: instead of returning normally with a return value, remote applications and the bus may decide to throw an error condition. However, the Qt D-Bus implementation does not use the C++ exception-throwing mechanism, so you will receive QDBusErrors in the return reply (see QDBusReply::error()).

QDBusError objects are used to inspect the error name and message as received from the bus and remote applications. You should not create such objects yourself to signal error conditions when called from D-Bus: instead, use QDBusMessage::createError() and QDBusConnection::send().

See also

QDBusMessage, QDBusReply, send().

Enums¶

ErrorType

In order to facilitate verification of the most common D-Bus errors generated by the D-Bus implementation and by the bus daemon itself, QDBusError can be compared to a set of pre-defined values:

Member

Value

Description
AccessDenied

9

The call/operation tried to access a resource it isn’t allowed to (org.freedesktop.DBus.Error.AccessDenied)
AddressInUse

13

QDBusServer tried to bind to an address that is already in use (org.freedesktop.DBus.Error.AddressInUse)
BadAddress

6

The address given is not valid (org.freedesktop.DBus.Error.BadAddress)
Disconnected

14

The call/process/message was sent after QDBusConnection disconnected (org.freedesktop.DBus.Error.Disconnected)
Failed

2

The call failed (org.freedesktop.DBus.Error.Failed)
InternalError

23

An internal error occurred
InvalidArgs

15

The arguments passed to this call/operation are not valid (org.freedesktop.DBus.Error.InvalidArgs)
InvalidInterface

26

The interface is invalid.
InvalidMember

27

The member is invalid.
InvalidObjectPath

25

The object path provided is invalid.
InvalidService

24

The service requested is invalid.
InvalidSignature

18

The type signature is not valid or compatible (org.freedesktop.DBus.Error.InvalidSignature)
LimitsExceeded

8

The limits allocated to this process/call/connection exceeded the pre-defined values (org.freedesktop.DBus.Error.LimitsExceeded)
NoError

0

QDBusError is invalid (i.e., the call succeeded)
NoMemory

3

Out of memory (org.freedesktop.DBus.Error.NoMemory)
NoNetwork

12

Documentation doesn’t say what this is for (org.freedesktop.DBus.Error.NoNetwork)
NoReply

5

The called method did not reply within the specified timeout (org.freedesktop.DBus.Error.NoReply)
NoServer

10

Documentation doesn’t say what this is for (org.freedesktop.DBus.Error.NoServer)
NotSupported

7

The call/operation is not supported (org.freedesktop.DBus.Error.NotSupported)
Other

1

QDBusError contains an error that is not one of the well-known ones
PropertyReadOnly

22

The property set failed because the property is read-only (org.freedesktop.DBus.Error.PropertyReadOnly)
ServiceUnknown

4

The called service is not known (org.freedesktop.DBus.Error.ServiceUnknown)
TimedOut

17

Documentation doesn’t say… (org.freedesktop.DBus.Error.TimedOut)
Timeout

11

Documentation doesn’t say what this is for or how it’s used (org.freedesktop.DBus.Error.Timeout)
UnknownInterface

19

The interface is not known in this object (org.freedesktop.DBus.Error.UnknownInterface)
UnknownMethod

16

The method called was not found in this object/interface with the given parameters (org.freedesktop.DBus.Error.UnknownMethod)
UnknownObject

20

The object path points to an object that does not exist (org.freedesktop.DBus.Error.UnknownObject)
UnknownProperty

21

The property does not exist in this interface (org.freedesktop.DBus.Error.UnknownProperty)

Methods¶

__init__(QDBusError)

Constructs a QDBusError from another QDBusError object

@staticmethod
errorString(ErrorType) → str

Returns the error name associated with error condition error.

isValid() → bool

Returns true if this is a valid error condition (i.e., if there was an error), otherwise false.

message() → str

Returns the message that the callee associated with this error. Error messages are implementation defined and usually contain a human-readable error code, though this does not mean it is suitable for your end-users.

name() → str

Returns this error’s name. Error names are similar to D-Bus Interface names, like org.freedesktop.DBus.InvalidArgs.

See also

type().

swap(QDBusError)

TODO

type() → ErrorType

TODO