Admin: 1 revision imported

2024-01-03T10:42:37Z

1 revision imported

1>Admin at 10:20, 3 January 2024

2024-01-03T10:20:48Z

New page

{{infobox function
|name=UserCredentialsLock
|object=[[Функции общего назначения]]
|caption=Административные функции
|type=1
|status=2
|db=1
|exception=Недостаточно прав, файловый сервер.
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Функции общего назначения]]}}
Функция временно блокирует доступ к редактору учетных записей пользователей (для подготовки к изменениям). Для исполнения функции необходимо наличие административных прав. '''Внимание''': после функции должен следовать блок <code><Try> ... <Finally><EndTry></code> для гарантированного вызова функции разблокировки [[UserCredentialsUnlock]]. Если доступ уже был заблокирован ранее, функция возвращает имя пользователя, машины и время, когда он был заблокирован.

== Синтаксис ==
<code>
'''UserCredentialsLock'''({{OptionalByRef|<Заблокировано пользователем (STRING)>}},{{OptionalByRef|<Заблокировано на машине (STRING)>}},{{OptionalByRef|<Время блокировки (DATE)>}}):''<0 или 1 (INT)>''
</code>
==== Аргументы ====
* <code>''<Заблокировано пользователем (STRING)>''</code> - {{Optional}}{{ByRef}} Аргумент-переменная возвращает имя пользователя, заблокировавшего доступ к учетным данным. Переменная будет заполнена только если функция возвратит 0.
* <code>''<Заблокировано на машине (STRING)>''</code> - {{Optional}}{{ByRef}} Аргумент-переменная возвращает имя компьютера, на котором был заблокирован доступ к учетным данным. Переменная будет заполнена только если функция возвратит 0.
* <code>''<Время блокировки (DATE)>''</code> - {{Optional}}{{ByRef}} Аргумент-переменная возвращает дату и время начала блокировки доступа к учетным данным. Переменная будет заполнена только если функция возвратит 0.

==== Возвращаемое значение ====
Возвращает 1 в случае успешной установки блокировки, иначе возвращает 0.

== Примеры ==
<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)

UserCredentialsLock - Revision history

Admin: 1 revision imported

1>Admin at 10:20, 3 January 2024