Класс 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

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