Admin: 1 revision imported

2021-02-07T06:51:48Z

1 revision imported

Admin at 10:51, 22 November 2020

2020-11-22T10:51:44Z

New page

{{infobox function
|name=MassUnlock
|object=[[Функции общего назначения]]
|caption=Разблокировка группы объектов
|type=1
|status=2
|db=1
|exception=Невозможно превратить в строку, число
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Функции общего назначения]]}}
Функция позволяет снять [[:Template:Типы блокировок системы|блокировку]] со множества объектов базы данных (или/и семафоров) по указанным правилам. Текстовые значения списка будут интерпретированы, как [[DBLockStringMutex|семафоры]], объекты базы данных, входящие в список, будут разблокированы, как [[DB.Unlock|объекты БД]]. Если какой-нибудь объект из списка (или семафор) не был заблокирован, элемент пропускается. Если объект (или семафор) из списка заблокирован другим пользователем, функция завершается с неудачей и заполняет аргументы ''Объект ошибки'', ''Заблокировано пользователем'', ''Заблокировано на машине'' и ''Время блокировки'' значениями, описывающими объект, разблокировать который не удалось. Данный режим больше всего подходит для семафоров, так как объекты базы данных будут иметь флаг блокировки без реальной блокировки на сервере только в случае внутренней ошибки системы.

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

==== Возвращаемое значение ====
Возвращает 1, все объекты списка были разблокированы, 0 -- если хотя бы один не был разблокирован.

== Примеры ==
<pre>
//Внимание: пример нельзя проверить на рабочей базе данных без изменения кодов объектов
a:=List.Create(DB("Ref.Номенклатура","Code","000000003661"),DB("Ref.Номенклатура","Code","000000007561"),"MUTEX01");
//Список содержит два объекта базы данных и одну строку, один из объектов является папкой.
аОбъект:=0;
аПольз:=0;
аМашина:=0;
аВремя:=0;
If MassLockWithWait(a,,,1000,аОбъект,аПольз,аМашина,аВремя) Then
Message("Блокировка произведена успешно");
If a.MassUnlock() Then
Message("Разблокировка произведена успешно");
Else
Message("Ошибка разблокировки. Внутренняя ошибка!","!");
EndIf;
Else
Message("Невозможно произвести блокировку объекта "+аОбъект+", он был заблокирован пользователем "+аПольз+" на машине "+аМашина+" в "+аВремя);
EndIf;
</pre>

← Older revision	Revision as of 06:51, 7 February 2021
(No difference)

MassUnlock - Revision history

Admin: 1 revision imported

Admin at 10:51, 22 November 2020