En esta página

QDBusError Class

La clase QDBusError representa un error recibido del bus D-Bus o de aplicaciones remotas presentes en el bus. Más información...

Encabezado: #include <QDBusError>
CMake: find_package(Qt6 REQUIRED COMPONENTS DBus)
target_link_libraries(mytarget PRIVATE Qt6::DBus)
qmake: QT += dbus

Tipos públicos

enum ErrorType { NoError, Other, Failed, NoMemory, ServiceUnknown, …, InvalidInterface }

Funciones públicas

bool isValid() const
QString message() const
QString name() const
void swap(QDBusError &other)
QDBusError::ErrorType type() const

Miembros públicos estáticos

QString errorString(QDBusError::ErrorType error)

Descripción detallada

Al trabajar con el servicio de bus D-Bus o con aplicaciones remotas a través de D-Bus, pueden producirse diversas condiciones de error. Estas condiciones de error a veces se señalan mediante un valor de error devuelto o mediante un QDBusError.

Las excepciones de C++ y Java son una analogía válida para los errores de D-Bus: en lugar de volver a la ejecución normal con un valor de retorno, las aplicaciones remotas y el bus pueden decidir lanzar una condición de error. Sin embargo, la implementación de Qt D-Bus no utiliza el mecanismo de lanzamiento de excepciones de C++, por lo que recibirás objetos QDBusError en la respuesta devuelta (véase QDBusReply::error()).

Los objetos QDBusError se utilizan para examinar el nombre y el mensaje del error tal y como se reciben del bus y de las aplicaciones remotas. No debe crear usted mismo dichos objetos para señalar condiciones de error cuando se le llame desde D-Bus: en su lugar, utilice QDBusMessage::createError() y QDBusConnection::send().

Véase también QDBusConnection::send(), QDBusMessage y QDBusReply.

Documentación sobre los tipos de miembros

enum QDBusError::ErrorType

Para facilitar la verificación de los errores de D-Bus más habituales generados por la implementación de D-Bus y por el propio demonio del bus, se puede comparar QDBusError con un conjunto de valores predefinidos:

ConstanteValorDescripción
QDBusError::NoError0QDBusError no es válido (es decir, la llamada se ha realizado correctamente)
QDBusError::Other1QDBusError contiene un error que no figura entre los conocidos
QDBusError::Failed2La llamada ha fallado (org.freedesktop.DBus.Error.Failed)
QDBusError::NoMemory3Se ha agotado la memoria (org.freedesktop.DBus.Error.NoMemory)
QDBusError::ServiceUnknown4El servicio al que se ha llamado es desconocido (org.freedesktop.DBus.Error.ServiceUnknown)
QDBusError::NoReply5El método invocado no respondió dentro del tiempo de espera especificado (org.freedesktop.DBus.Error.NoReply)
QDBusError::BadAddress6La dirección indicada no es válida (org.freedesktop.DBus.Error.BadAddress)
QDBusError::NotSupported7La llamada/operación no es compatible (org.freedesktop.DBus.Error.NotSupported)
QDBusError::LimitsExceeded8Los límites asignados a este proceso/llamada/conexión han superado los valores predefinidos (org.freedesktop.DBus.Error.LimitsExceeded)
QDBusError::AccessDenied9La llamada/operación ha intentado acceder a un recurso al que no tiene permiso (org.freedesktop.DBus.Error.AccessDenied)
QDBusError::NoServer10La documentación no indica para qué sirve esto (org.freedesktop.DBus.Error.NoServer)
QDBusError::Timeout11La documentación no indica para qué sirve esto ni cómo se utiliza (org.freedesktop.DBus.Error.Timeout)
QDBusError::NoNetwork12La documentación no explica para qué sirve esto (org.freedesktop.DBus.Error.NoNetwork)
QDBusError::AddressInUse13QDBusServer Se ha intentado vincular a una dirección que ya está en uso (org.freedesktop.DBus.Error.AddressInUse)
QDBusError::Disconnected14La llamada/el proceso/el mensaje se envió después de que QDBusConnection se desconectara (org.freedesktop.DBus.Error.Disconnected)
QDBusError::InvalidArgs15Los argumentos pasados a esta llamada/operación no son válidos (org.freedesktop.DBus.Error.InvalidArgs)
QDBusError::UnknownMethod16No se ha encontrado el método llamado en este objeto/interfaz con los parámetros indicados (org.freedesktop.DBus.Error.UnknownMethod)
QDBusError::TimedOut17La documentación no lo indica... (org.freedesktop.DBus.Error.TimedOut)
QDBusError::InvalidSignature18La firma de tipo no es válida o no es compatible (org.freedesktop.DBus.Error.InvalidSignature)
QDBusError::UnknownInterface19La interfaz no se reconoce en este objeto (org.freedesktop.DBus.Error.UnknownInterface)
QDBusError::UnknownObject20La ruta del objeto apunta a un objeto que no existe (org.freedesktop.DBus.Error.UnknownObject)
QDBusError::UnknownProperty21La propiedad no existe en esta interfaz (org.freedesktop.DBus.Error.UnknownProperty)
QDBusError::PropertyReadOnly22El establecimiento de la propiedad ha fallado porque la propiedad es de solo lectura (org.freedesktop.DBus.Error.PropertyReadOnly)
QDBusError::InternalError23Se ha producido un error interno
QDBusError::InvalidObjectPath25La ruta del objeto proporcionada no es válida.
QDBusError::InvalidService24El servicio solicitado no es válido.
QDBusError::InvalidMember27El miembro no es válido.
QDBusError::InvalidInterface26La interfaz no es válida.

Documentación de la función de miembro

[static] QString QDBusError::errorString(QDBusError::ErrorType error)

Devuelve el nombre del error asociado a la condición de error « error ».

bool QDBusError::isValid() const

Devuelve « true » si se trata de una condición de error válida (es decir, si se ha producido un error); en caso contrario, devuelve «false».

QString QDBusError::message() const

Devuelve el mensaje asociado a este error por parte de la función llamada. Los mensajes de error vienen definidos por la implementación y suelen contener un código de error legible para las personas, aunque esto no significa que sea adecuado para tus usuarios finales.

QString QDBusError::name() const

Devuelve el nombre de este error. Los nombres de los errores son similares a los nombres de las interfaces de D-Bus, como org.freedesktop.DBus.InvalidArgs.

Véase también type().

[noexcept] void QDBusError::swap(QDBusError &other)

Sustituye este error por other. Esta operación es muy rápida y nunca falla.

QDBusError::ErrorType QDBusError::type() const

Devuelve el « ErrorType » de este error.

Véase también ErrorType.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.