Класс UserManager

(Sailfish::Mdm::UserManager)

Управление пользователями системы. Подробнее…

Заголовочный файл:

#include <mdm-usermanager.h>

Список всех членов класса, включая унаследованные

Публичные типы

class UserEntry

Публичные методы

UserManager(QObject *parent = 0)
virtual ~UserManager()
bool addToGroups(uint uid, const QStringList &groups)
uint addUser(const QString &userLogin)
uint addUserWithParam(const QString &userLogin, const QString &userName, uint quota)
uint addUserWithParam(const QString &userLogin, const QString &userName, uint quota, bool percent)
uint currentUser()
QString currentUserUuid()
uint enableUserQuota(bool enable)
QVariantMap getUserQuotaInfo()
bool modifyUser(uint uid, const QString &newFullName)
bool removeFromGroups(uint uid, const QStringList &groups)
bool removeUser(uint uid)
bool setCurrentUser(uint uid)
bool setNextSessionUser(uint uid)
QString userUuid(uint uid)
QList<UserEntry> users()
QStringList usersGroups(uint uid)

Сигналы

void userAddFailed(const QString &error, const QString &message)
void userAdded(const UserEntry &user)

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

Управление пользователями системы.

Для использования данного класса в qmake-настройки проекта клиента следует добавить следующее:

 CONFIG += link_pkgconfig
 PKGCONFIG += sailfishmdm

и затем #include <mdm-usermanager.h>.

Пример использования:

 #include <mdm-usermanager.h>

 void addUser()
 {
     Sailfish::Mdm::UserManager user;
     qInfo() << user.addUser("userName");
 }

Описание методов класса

UserManager::UserManager(QObject *parent = 0)

Конструктор для класса UserManager с родительским элементом, указанным в параметре parent.

[virtual] UserManager::~UserManager()

Деструктор для класса UserManager.

bool UserManager::addToGroups(uint uid, const QStringList &groups)

Добавляет groups для пользователя с идентификатором uid. Пользователь не добавляется ни в одну из групп, если не удаётся добавить пользователя хотя бы в одну из групп.

Возвращает true, если пользователь добавлен, в противном случае возвращает false.

uint UserManager::addUser(const QString &userLogin)

Создаёт нового пользователя с логином userLogin.

Возвращает UID созданного нового пользователя, если пользователь был добавлен успешно.

uint UserManager::addUserWithParam(const QString &userLogin, const QString &userName, uint quota)

Устарел: создаётся новый пользователь с userLogin userName и quota.

Возвращает UID созданного нового пользователя, если пользователь был добавлен успешно.

uint UserManager::addUserWithParam(const QString &userLogin, const QString &userName, uint quota, bool percent)

Создаёт нового пользователя с логином userLogin, именем userName и долей quota.

Возвращает UID созданного нового пользователя, если пользователь был добавлен успешно.

uint UserManager::currentUser()

Возвращает текущий идентификатор пользователя.

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

QString UserManager::currentUserUuid()

Возвращает текущий uid пользователя.

uint UserManager::enableUserQuota(bool enable)

Включает/выключает квоту пользователя.

Возвращает 0 в случае успеха, в противном случае — код ошибки.

QVariantMap UserManager::getUserQuotaInfo()

Возвращает информацию о квоте для нового пользователя.

Возвращает словарь, содержащий информацию.

bool UserManager::modifyUser(uint uid, const QString &newFullName)

Изменяет настоящее имя на newFullName для пользователя с данным uid, если модификация была успешно применена.

Возвращает true, если профиль пользователя изменился, в противном случае возвращает false.

bool UserManager::removeFromGroups(uint uid, const QStringList &groups)

Удаляет groups для пользователя с uid.

Возвращает true, если пользователь удален из групп, в противном случае возвращает false.

bool UserManager::removeUser(uint uid)

Удаляет пользователя с uid.

Возвращает true, если пользователь успешно удалён, в противном случае возвращает false.

bool UserManager::setCurrentUser(uint uid)

Переключается на пользователя с переданным uid. Указанный пользователь будет использован в следующей пользовательской сессии.

Примечание — Этот метод не перезагружает устройство.

Возвращает true, если пользователь переключён, в противном случае возвращает false.

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

bool UserManager::setNextSessionUser(uint uid)

Устанавливает пользователя с заданным идентификатором uid. Указанный пользователь будет установлен в качестве текущего пользователя после перезагрузки/выключения.

Примечание — Этот метод не перезагружает устройство.

Возвращает true, если uid корректный, в противном случае возвращает false.

[signal] void UserManager::userAddFailed(const QString &error, const QString &message)

[signal] void UserManager::userAdded(const UserEntry &user)

QString UserManager::userUuid(uint uid)

Возвращает uuid пользователя с uid.

QList<UserEntry> UserManager::users()

Возвращает список экземпляров UserEntry.

QStringList UserManager::usersGroups(uint uid)

Возвращает список групп пользователя с uid.