Класс QDBusConnectionInterface

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

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

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

Типы публичного доступа

Свойства

• activatableServiceNames : const QDBusReply<QStringList>
• 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

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

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

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

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

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

Возвращает идентификатор пользователя (UID) в Unix для процесса, в данный момент владеющего сервисом шины 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(). Если это приложение владело именем, оно будет освобождено для других приложений. Если у него было только имя в очереди, оно откажется от своего места в очереди.