QDBusConnectionInterface Class
La clase `QDBusConnectionInterface` permite acceder al servicio del demonio del bus D-Bus. Más información...
| Encabezado: | #include <QDBusConnectionInterface> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS DBus) target_link_libraries(mytarget PRIVATE Qt6::DBus) |
| qmake: | QT += dbus |
| Heredado de: | QDBusAbstractInterface |
Tipos públicos
| enum | RegisterServiceReply { ServiceNotRegistered, ServiceRegistered, ServiceQueued } |
| enum | ServiceQueueOptions { DontQueueService, QueueService, ReplaceExistingService } |
| enum | ServiceReplacementOptions { DontAllowReplacement, AllowReplacement } |
Propiedades
- activatableServiceNames : QDBusReply<QStringList>
- registeredServiceNames : QDBusReply<QStringList>
Ranuras públicas
| QDBusReply<QStringList> | activatableServiceNames() const |
| QDBusReply<bool> | isServiceRegistered(const QString &serviceName) const |
| QDBusReply<QDBusConnectionInterface::RegisterServiceReply> | registerService(const QString &serviceName, QDBusConnectionInterface::ServiceQueueOptions qoption = DontQueueService, QDBusConnectionInterface::ServiceReplacementOptions roption = DontAllowReplacement) |
| QDBusReply<QStringList> | registeredServiceNames() const |
(since 6.10) QDBusReply<QVariantMap> | serviceCredentials(const QString &serviceName) const |
| QDBusReply<QString> | serviceOwner(const QString &name) const |
| QDBusReply<uint> | servicePid(const QString &serviceName) const |
| QDBusReply<uint> | serviceUid(const QString &serviceName) const |
| QDBusReply<void> | startService(const QString &name) |
| QDBusReply<bool> | unregisterService(const QString &serviceName) |
Señales
| void | callWithCallbackFailed(const QDBusError &error, const QDBusMessage &call) |
| void | serviceRegistered(const QString &service) |
| void | serviceUnregistered(const QString &service) |
Descripción detallada
El demonio del servidor de bus D-Bus proporciona una interfaz especial, ` org.freedesktop.DBus `, que permite a los clientes acceder a determinadas propiedades del bus, como la lista actual de clientes conectados. La clase `QDBusConnectionInterface` proporciona acceso a dicha interfaz.
Los usos más habituales de esta clase son registrar y dar de baja nombres de servicios en el bus mediante las funciones registerService() y unregisterService(), consultar los nombres existentes mediante las funciones isServiceRegistered(), registeredServiceNames() y serviceOwner(), y recibir notificaciones de que un cliente se ha registrado o dado de baja a través de las señales serviceRegistered(), serviceUnregistered() y serviceOwnerChanged().
Documentación sobre los tipos de miembro
enum QDBusConnectionInterface::RegisterServiceReply
Los posibles valores de retorno de la función ` registerService()` son:
| Constante | Valor | Descripción |
|---|---|---|
QDBusConnectionInterface::ServiceNotRegistered | 0 | La llamada ha fallado y el nombre del servicio no se ha registrado. |
QDBusConnectionInterface::ServiceRegistered | 1 | El autor de la llamada es ahora el propietario del nombre del servicio. |
QDBusConnectionInterface::ServiceQueued | 2 | El solicitante especificó el indicador « QueueService » y el servicio ya estaba registrado, por lo que estamos en cola. |
Se emitirá la señal « serviceRegistered()» cuando esta aplicación adquiera el servicio.
enum QDBusConnectionInterface::ServiceQueueOptions
Indicadores que determinan cómo debe comportarse el registro de un servicio en caso de que el nombre del servicio ya esté registrado.
| Constante | Valor | Descripción |
|---|---|---|
QDBusConnectionInterface::DontQueueService | 0 | Si una aplicación solicita un nombre que ya está en uso, no se realizará ninguna puesta en cola. La llamada a registeredService() simplemente fallará. Este es el valor por defecto. |
QDBusConnectionInterface::QueueService | 1 | Intenta registrar el servicio solicitado, pero no intenta sustituirlo si otra aplicación ya lo tiene registrado. En su lugar, simplemente coloca esta aplicación en la cola hasta que se renuncie a ella. Cuando eso ocurra, se emitirá la señal « serviceRegistered()». |
QDBusConnectionInterface::ReplaceExistingService | 2 | Si otra aplicación ya tiene registrado el nombre del servicio, se intentará sustituirlo. |
Véase también ` ServiceReplacementOptions`.
enum QDBusConnectionInterface::ServiceReplacementOptions
Indicadores para determinar si el servidor D-Bus debe permitir que otra aplicación sustituya un nombre que esta aplicación haya registrado con la opción « ReplaceExistingService ».
Los valores posibles son:
| Constante | Valor | Descripción |
|---|---|---|
QDBusConnectionInterface::DontAllowReplacement | 0 | No permitir que otra aplicación nos sustituya. El servicio debe darse de baja explícitamente mediante ` unregisterService()` para que otra aplicación pueda adquirirlo. Este es el valor predeterminado. |
QDBusConnectionInterface::AllowReplacement | 1 | Permitir que otras aplicaciones nos sustituyan mediante la opción ` ReplaceExistingService ` de ` registerService()` sin intervención alguna. Si esto ocurre, se emitirá la señal ` serviceUnregistered()`. |
Véase también ServiceQueueOptions.
Documentación de la propiedad
[read-only] activatableServiceNames : QDBusReply<QStringList>
contiene los nombres de los servicios que se pueden activar
Enumera todos los nombres que se pueden activar en el bus.
Funciones de acceso:
| QDBusReply<QStringList> | activatableServiceNames() const |
[read-only] registeredServiceNames : QDBusReply<QStringList>
contiene los nombres de los servicios registrados
Enumera todos los nombres registrados actualmente en el bus.
Funciones de acceso:
| QDBusReply<QStringList> | registeredServiceNames() const |
Documentación de las funciones de los miembros
[signal] void QDBusConnectionInterface::callWithCallbackFailed(const QDBusError &error, const QDBusMessage &call)
Esta señal se emite cuando se produce un error durante una llamada a ` QDBusConnection::callWithCallback()`. ` error ` especifica el error. ` call ` es el mensaje que no se ha podido entregar.
Véase también QDBusConnection::callWithCallback().
[slot] QDBusReply<bool> QDBusConnectionInterface::isServiceRegistered(const QString &serviceName) const
Devuelve « true » si el nombre del servicio « serviceName » está registrado actualmente.
[slot] QDBusReply<QDBusConnectionInterface::RegisterServiceReply> QDBusConnectionInterface::registerService(const QString &serviceName, QDBusConnectionInterface::ServiceQueueOptions qoption = DontQueueService, QDBusConnectionInterface::ServiceReplacementOptions roption = DontAllowReplacement)
Solicita el registro del nombre de servicio « serviceName » en el bus. El indicador « qoption » especifica cómo debe comportarse el servidor D-Bus si « serviceName » ya está registrado. El indicador « roption » especifica si el servidor debe permitir que otra aplicación sustituya nuestro nombre registrado.
Si el registro del servicio se realiza con éxito, se emitirá la señal serviceRegistered(). Si se nos coloca en cola, la señal se emitirá cuando obtengamos el nombre. Si roption es AllowReplacement, se emitirá la señal serviceUnregistered() si otra aplicación sustituye a esta.
Véase también unregisterService().
[slot, since 6.10] QDBusReply<QVariantMap> QDBusConnectionInterface::serviceCredentials(const QString &serviceName) const
Devuelve las credenciales de conexión del proceso que actualmente mantiene el servicio de bus serviceName.
Consulte <https://dbus.freedesktop.org/doc/dbus-specification.html>, sección: «Método: org.freedesktop.DBus.GetConnectionCredentials» para obtener más información.
Esta función se introdujo en Qt 6.10.
[slot] QDBusReply<QString> QDBusConnectionInterface::serviceOwner(const QString &name) const
Devuelve el nombre de conexión único del propietario principal del nombre name. Si el nombre solicitado no tiene propietario, devuelve un error de tipo « org.freedesktop.DBus.Error.NameHasNoOwner ».
[slot] QDBusReply<uint> QDBusConnectionInterface::servicePid(const QString &serviceName) const
Devuelve el identificador de proceso (PID) de Unix correspondiente al proceso que actualmente controla el servicio de bus serviceName.
[signal] void QDBusConnectionInterface::serviceRegistered(const QString &service)
Esta señal la emite el servidor D-Bus cuando esta aplicación adquiere el nombre del servicio de bus (nombre de conexión único o nombre de servicio conocido) proporcionado por service.
La adquisición tiene lugar después de que esta aplicación haya solicitado un nombre mediante registerService().
[slot] QDBusReply<uint> QDBusConnectionInterface::serviceUid(const QString &serviceName) const
Devuelve el identificador de usuario de Unix (UID) del proceso que actualmente tiene en su poder el servicio de bus serviceName.
[signal] void QDBusConnectionInterface::serviceUnregistered(const QString &service)
El servidor D-Bus emite esta señal cuando esta aplicación pierde la propiedad del nombre del servicio de bus proporcionado por service.
[slot] QDBusReply<void> QDBusConnectionInterface::startService(const QString &name)
Solicita que el autobús inicie el servicio denominado « name ».
[slot] QDBusReply<bool> QDBusConnectionInterface::unregisterService(const QString &serviceName)
Libera la reserva del nombre del servicio de autobús « serviceName », que se había registrado previamente en registerService(). Si esta solicitud tenía la titularidad del nombre, este quedará libre para que otras solicitudes puedan reclamarlo. Si solo tenía el nombre en cola, renuncia a su posición en la cola.
© 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.