Класс QDBusConnectionInterface

Класс QDBusConnectionInterface предоставляет доступ к службе демона шины D-Bus. Подробнее...

Этот класс был представлен в Qt 4.2.

• Список всех членов, включая унаследованные
• Устаревшие члены

Общедоступные типы

Свойства

• registeredServiceNames : const QDBusReply<QStringList>

Общедоступные слоты

Сигналы

Подробное описание

Сервер демона шины D-Bus предоставляет один специальный интерфейс org.freedesktop.DBus, который позволяет клиентам получать доступ к определённым свойствам шины, таким как текущий список подключённых клиентов. Класс QDBusConnectionInterface предоставляет доступ к этому интерфейсу.

Наиболее распространённое использование этого класса заключается в регистрации и отмене регистрации имён служб в шине с помощью функций registerService() и unregisterService(), запросе информации о существующих именах с помощью функций isServiceRegistered(), registeredServiceNames() и serviceOwner(), а также получении уведомлений о регистрации или отмене регистрации клиента через сигналы serviceRegistered(), serviceUnregistered() и serviceOwnerChanged().

Документация по типам членов

Перечисление QDBusConnectionInterface::RegisterServiceReply

Возможные возвращаемые значения от registerService():

Сигнал serviceRegistered() будет выпущен, когда служба будет приобретена этим приложением.

Перечисление QDBusConnectionInterface::ServiceQueueOptions

Флаги для определения поведения регистрации службы в случае, если имя службы уже зарегистрировано.

См. также ServiceReplacementOptions.

Перечисление QDBusConnectionInterface::ServiceReplacementOptions

Флаги для определения, должно ли приложение D-Bus сервера разрешать другому приложению заменить имя, которое это приложение зарегистрировало с помощью параметра ReplaceExistingService.

Возможные значения:

См. также ServiceQueueOptions.

Документация по функциям-членам

[signal] void QDBusConnectionInterface::callWithCallbackFailed(const QDBusError &error, const QDBusMessage &call)

Этот сигнал испускается, когда возникает ошибка во время вызова QDBusConnection::callWithCallback(). error указывает на ошибку. call — это сообщение, которое не удалось доставить.

См. также QDBusConnection::callWithCallback().

[slot] QDBusReply<bool> QDBusConnectionInterface::isServiceRegistered(const QString &serviceName) const

Возвращает true, если имя службы serviceName в данный момент зарегистрировано.

[slot] QDBusReply<QDBusConnectionInterface::RegisterServiceReply> QDBusConnectionInterface::registerService(const QString &serviceName, QDBusConnectionInterface::ServiceQueueOptions qoption = DontQueueService, QDBusConnectionInterface::ServiceReplacementOptions roption = DontAllowReplacement)

Запрос на регистрацию имени службы serviceName в шине. Флаг qoption определяет, как сервер D-Bus должен вести себя, если serviceName уже зарегистрировано. Флаг roption определяет, должен ли сервер разрешить другому приложению заменить наше зарегистрированное имя.

Если регистрация службы прошла успешно, будет испущен сигнал serviceRegistered(). Если мы попали в очередь, сигнал будет испущен, когда мы получим имя. Если roption равен AllowReplacement, сигнал serviceUnregistered() будет испущен, если другое приложение заменит это.

См. также unregisterService().

[slot] QDBusReply<QString> QDBusConnectionInterface::serviceOwner(const QString &name) const

Возвращает уникальное имя подключения основного владельца имени name. Если у запрошенного имени нет владельца, возвращается ошибка org.freedesktop.DBus.Error.NameHasNoOwner.

[slot] QDBusReply<uint> QDBusConnectionInterface::servicePid(const QString &serviceName) const

Возвращает идентификатор процесса Unix (PID) процесса, который в данный момент владеет службой шины serviceName.

[signal] void QDBusConnectionInterface::serviceRegistered(const QString &service)

Этот сигнал испускается сервером D-Bus, когда имя службы шины (уникальное имя подключения или известное имя службы), заданное service, получено этим приложением.

Получение происходит после того, как это приложение запросило имя с помощью registerService().

[slot] QDBusReply<uint> QDBusConnectionInterface::serviceUid(const QString &serviceName) const

Возвращает идентификатор пользователя Unix (UID) процесса, который в данный момент владеет службой шины serviceName.

[signal] void QDBusConnectionInterface::serviceUnregistered(const QString &service)

Этот сигнал испускается сервером D-Bus, когда это приложение теряет владение именем службы шины, заданным service.

[slot] QDBusReply<void> QDBusConnectionInterface::startService(const QString &name)

Запрашивает, чтобы шина запустила службу, заданную именем name.

[slot] QDBusReply<bool> QDBusConnectionInterface::unregisterService(const QString &serviceName)

Освобождает владение именем службы шины serviceName, которое было ранее зарегистрировано с помощью registerService(). Если у этого приложения было владение именем, оно будет освобождено для других приложений, чтобы они его захватили. Если у него было только имя в очереди, оно отказывается от своего места в очереди.