D-Bus интерфейс ru.omp.ManagedConfiguration.Application1
Интерфейс для получения информации о текущих конфигурационных параметрах и отслеживания сигналов об изменении конфигурации во время исполнения.
Шина: | системная |
Служба: | ru.omp.ManagedConfiguration |
Объект: | {orgname}.{appname} |
Интерфейс: | ru.omp.ManagedConfiguration.Application1 |
Сигналы
Методы
- ChangeConfiguration(map<string, variant> configuration)
- GetConfiguration(map<string, variant> &configuration)
Подробное описание
Каждому приложению доступен объект с именем формата {orgname}.{appname}
.
Через этот объект приложения могут получать информацию о текущих конфигурационных параметрах
и отслеживать сигналы об изменении конфигурации во время своего исполнения.
Если для приложения доступна глобальная конфигурация и конфигурация для текущего пользователя, то предпочитается конфигурация для текущего пользователя.
Приложениям, использующим данный интерфейс, необходимо указать разрешение
ManagedConfiguration
.
Описание сигналов
ConfigurationChanged()
Уведомляет приложение об изменённой конфигурации.
После получения сигнала приложение должно вызвать метод
GetConfiguraiton
.
Описание методов
ChangeConfiguration(map<string, variant> configuration)
Изменяет конфигурацию приложения для текущего пользователя.
configuration
— словарь пар ключ-значение, изменённые параметры конфигурации.
Возможные ошибки:
InvalidType
— попытка установить значение недопустимого типа.InvalidValue
— попытка установить недопустимое значение.ForbiddenToChange
— попытка изменить недоступную конфигурацию.
GetConfiguration(map<string, variant> &configuration)
Возвращают текущую конфигурацию приложения.
configuration
— словарь пар ключ-значение, описывающих параметры конфигурации.