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:
| Constante | Valor | Descripción |
|---|---|---|
QDBusError::NoError | 0 | QDBusError no es válido (es decir, la llamada se ha realizado correctamente) |
QDBusError::Other | 1 | QDBusError contiene un error que no figura entre los conocidos |
QDBusError::Failed | 2 | La llamada ha fallado (org.freedesktop.DBus.Error.Failed) |
QDBusError::NoMemory | 3 | Se ha agotado la memoria (org.freedesktop.DBus.Error.NoMemory) |
QDBusError::ServiceUnknown | 4 | El servicio al que se ha llamado es desconocido (org.freedesktop.DBus.Error.ServiceUnknown) |
QDBusError::NoReply | 5 | El método invocado no respondió dentro del tiempo de espera especificado (org.freedesktop.DBus.Error.NoReply) |
QDBusError::BadAddress | 6 | La dirección indicada no es válida (org.freedesktop.DBus.Error.BadAddress) |
QDBusError::NotSupported | 7 | La llamada/operación no es compatible (org.freedesktop.DBus.Error.NotSupported) |
QDBusError::LimitsExceeded | 8 | Los límites asignados a este proceso/llamada/conexión han superado los valores predefinidos (org.freedesktop.DBus.Error.LimitsExceeded) |
QDBusError::AccessDenied | 9 | La llamada/operación ha intentado acceder a un recurso al que no tiene permiso (org.freedesktop.DBus.Error.AccessDenied) |
QDBusError::NoServer | 10 | La documentación no indica para qué sirve esto (org.freedesktop.DBus.Error.NoServer) |
QDBusError::Timeout | 11 | La documentación no indica para qué sirve esto ni cómo se utiliza (org.freedesktop.DBus.Error.Timeout) |
QDBusError::NoNetwork | 12 | La documentación no explica para qué sirve esto (org.freedesktop.DBus.Error.NoNetwork) |
QDBusError::AddressInUse | 13 | QDBusServer Se ha intentado vincular a una dirección que ya está en uso (org.freedesktop.DBus.Error.AddressInUse) |
QDBusError::Disconnected | 14 | La llamada/el proceso/el mensaje se envió después de que QDBusConnection se desconectara (org.freedesktop.DBus.Error.Disconnected) |
QDBusError::InvalidArgs | 15 | Los argumentos pasados a esta llamada/operación no son válidos (org.freedesktop.DBus.Error.InvalidArgs) |
QDBusError::UnknownMethod | 16 | No se ha encontrado el método llamado en este objeto/interfaz con los parámetros indicados (org.freedesktop.DBus.Error.UnknownMethod) |
QDBusError::TimedOut | 17 | La documentación no lo indica... (org.freedesktop.DBus.Error.TimedOut) |
QDBusError::InvalidSignature | 18 | La firma de tipo no es válida o no es compatible (org.freedesktop.DBus.Error.InvalidSignature) |
QDBusError::UnknownInterface | 19 | La interfaz no se reconoce en este objeto (org.freedesktop.DBus.Error.UnknownInterface) |
QDBusError::UnknownObject | 20 | La ruta del objeto apunta a un objeto que no existe (org.freedesktop.DBus.Error.UnknownObject) |
QDBusError::UnknownProperty | 21 | La propiedad no existe en esta interfaz (org.freedesktop.DBus.Error.UnknownProperty) |
QDBusError::PropertyReadOnly | 22 | El establecimiento de la propiedad ha fallado porque la propiedad es de solo lectura (org.freedesktop.DBus.Error.PropertyReadOnly) |
QDBusError::InternalError | 23 | Se ha producido un error interno |
QDBusError::InvalidObjectPath | 25 | La ruta del objeto proporcionada no es válida. |
QDBusError::InvalidService | 24 | El servicio solicitado no es válido. |
QDBusError::InvalidMember | 27 | El miembro no es válido. |
QDBusError::InvalidInterface | 26 | La 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.