Класс QDBusConnectionInterface

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

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

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

Свойства

• registeredServiceNames : const QDBusReply<QStringList>

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

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

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

Сигналы

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

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

• 15 открытых функций унаследовано от QDBusAbstractInterface
• 34 открытых функции унаследовано от QObject
• 1 открытая переменная унаследована от QObject
• 10 статических открытых членов унаследовано от QObject
• 9 защищённых функций унаследовано от QObject
• 2 защищённых переменных унаследовано от 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, 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. Если у запрошенного имени нет владельца, возвращается ошибка.

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