Admin: 1 revision imported

2024-01-03T10:42:37Z

1 revision imported

1>Admin: Created page with "{{infobox function |name=UserCredentialsLoad |object=Функции общего назначения |caption=Административные функции |type=1 |sta..."

2024-01-03T10:33:51Z

Created page with "{{infobox function |name=UserCredentialsLoad |object=Функции общего назначения |caption=Административные функции |type=1 |sta..."

New page

{{infobox function
|name=UserCredentialsLoad
|object=[[Функции общего назначения]]
|caption=Административные функции
|type=1
|status=2
|db=1
|exception=Недостаточно прав, файловый сервер, ошибка сервера.
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Функции общего назначения]]}}
Функция получает строку-содежимое файла учетных записей пользователей с сервера. Для исполнения функции необходимо наличие административных прав. Строку можно использовать, к примеру, для заполнения объекта [[Ini-файл|ini-файла]]. Чтение учетных записей пользователей, без их предвариельной блокировки функцией [[UserCredentialsLock]], разрешено, однако если данные будут изменяться, необходимо убедиться, что вы читаете актуальную копию данных, поэтому необходимо использование [[UserCredentialsLock]] до начала чтения.

Файл имеет структуру Ini-файла. Установки учетной записи каждого из пользователей следуют в своей ветке. В каждой из веток могут содержаться следующие переменные (не исключено, что каких-то из переменых не будет, либо могут присутствовать неописанные здесь переменные): '''Password''' (только в режиме хранения открытых текстов паролей), '''PasswordHash''' (MD5 хеш, только в режиме хранения хешей), '''ifDisabled''' (запрет доступа пользователя), '''ifAdministrator''' (уровень полномочий), '''ifProtected''' (защита от проверки пароля с помощью NTLM), '''FirstLogon''' (дата и время первого входа в формате Int64 Windows), '''LastLogon''' (дата и время последнего входа в формате Int64 Windows), '''DisableNotice''' (сообщение о причине блокировки).

Для допонительной информации см. статью [[Установки сервера]].

== Синтаксис ==
<code>
'''UserCredentialsLoad'''():''<Файл учетных записей сервера в виде строки (STRING)>''
</code>

==== Возвращаемое значение ====
Возвращает строку-содержимое файла учетных записей, если это сделать невозможно, функция вызовет исключение.

== Примеры ==
<pre>
//Фрагмент блокирует доступ пользователя Нарушитель2" к серверу базы данных.
бПольз:="Нарушитель2";

аПольз:="";
аМаш:="";
аВремя:=0;
If not UserCredentialsLock(аПольз,аМаш,аВремя) Then
Message("Учетные записи заблокированы администратором "+аПольз+" на компьютере "+аМаш+" в "+FormatDate(аВремя,"DD.mm.YYYY hh:tt:ss")+"!","!");
Exit;
EndIf;
Try
Стр:=UserCredentialsLoad;
//Загрузка файла учетных записей в объект Ini-файла
aIni:=Ini.Create();
If aIni.AddFromString(Стр) Then
If not aIni.DoesExist(бПольз+"\") Then
Message("Пользователь "+бПольз+" не зарегистрирован на сервере!","!");
ElseIf Number(aIni.GetData(бПольз+"\ifDisabled","0"))<>0 Then
Message("Пользователь "+бПольз+" уже был заблокирован!","I");
Else
//Добавим или обновим переменную ifDisabled.
aIni.AddLeaf(бПольз+"\ifDisabled","1");
Стр:=aIni.StoreToString("");
//Удалить все комментарии (необязательный шаг)
Стр:=ReplaceRE(Стр,"^;.*\R","");
//Сохраним результат на сервере
If UserCredentialsStore(Стр) Then
Message("Пользователь "+бПольз+" был успешно заблокирован!","I");
Else
Message("Ошибка сохранения учетных записей пользователей!","!");
EndIf;
EndIf;
EndIf;
Finally
UserCredentialsUnlock();
EndTry;
</pre>

← Older revision	Revision as of 10:42, 3 January 2024
(No difference)

UserCredentialsLoad - Revision history

Admin: 1 revision imported

1>Admin: Created page with "{{infobox function |name=UserCredentialsLoad |object=Функции общего назначения |caption=Административные функции |type=1 |sta..."