Класс QDBusConnectionInterface

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

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

Открытые типы

Свойства

• registeredServiceNames : const QDBusReply<QStringList>

• 1 свойство унаследовано от QObject

Открытые слоты

• 1 открытый слот унаследован от QObject

Сигналы

• 2 сигнала унаследованы от QObject

Дополнительные унаследованные члены

• 15 открытых функций унаследовано от QDBusAbstractInterface
• 32 открытых функции унаследовано от QObject
• 11 статические открытые члены унаследованы от QObject
• 9 защищенных функций унаследовано от QObject

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

Класс QDBusConnectionInterface предоставляет доступ к службе D-Bus.

Сервер 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, ServiceQueueOptions qoption = DontQueueService, ServiceReplacementOptions roption = DontAllowReplacement)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Запрашивает запуск службы с именем name в шине.

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

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