DBIsStringMutexLocked - Revision history

Admin: 1 revision imported

2021-04-16T14:16:53Z

1 revision imported

1>Admin at 09:53, 21 March 2021

2021-03-21T09:53:46Z

Admin: 1 revision imported

2021-02-07T06:43:27Z

1 revision imported

Admin at 15:14, 9 June 2019

2019-06-09T15:14:44Z

New page

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

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

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

== Примеры ==
<pre>
//Блок позволяет проверить, выполняется ли уже обмен с центральной базой
ИмяБлок:="Обмен с центральной базой";
аПольз:="";аМаш:="";аДата:="";
If DBIsStringMutexLocked(ИмяБлок,аПольз,аМаш,аДата) Then
Message("Обмен с с центральной базой уже выполняет пользователь "+аПольз+" ("+аМаш+"), начало "+аДата+"! Дождитесь окончания предыдущего обмена!","!");
Else
Message("В данный момент обмен с центральной базой не выполняется!");
EndIf;
</pre>

← Older revision	Revision as of 14:16, 16 April 2021
(No difference)

@@ Line 4: / Line 4: @@
 |caption=Серверные функции
 |type=1
-|status=0
+|status=2
 |db=1
 |exception=Невозможно превратить в строку
@@ Line 21: / Line 21: @@
 ==== Аргументы ====
 * <code>''<Имя семафора (STRING)>''</code> - Имя серверного семафора, который необходимо проверить
-* <code>''<Заблокировано пользователем (STRING)>,<Заблокировано на машине (STRING)>,<Время блокировки (DATE)>''</code> - {{ByRef}} {{Optional}} Переменные, получающие информацию о том, кто, где и в какое время произвел блокировку семафора, если он заблокирован.
+* <code>''<Заблокировано пользователем (STRING)>,<Заблокировано на машине (STRING)>,<Время блокировки (DATE)>''</code> - {{ByRef}} {{Optional}} Переменные, получающие информацию о том, кто, где и в какое время произвел блокировку семафора, если он заблокирован. Если семафор заблокирован в текущем потоке, либо не заблокирован, значение этих переменных не изменяется.
 ==== Возвращаемое значение ====
-Возвращает 1, если семафор заблокирован, иначе возвращает 0.
+Возвращает число, которое может принимать следующие значения:
 == Примеры ==
 <pre>
-//Блок позволяет проверить, выполняется ли уже обмен с центральной базой
+//Блок может использовать для информативной проверки возможности совершить обмен. До начала обмена, однако,
 ИмяБлок:="Обмен с центральной базой";
 аПольз:="";аМаш:="";аДата:="";
-If DBIsStringMutexLocked(ИмяБлок,аПольз,аМаш,аДата) Then
+If DBIsStringMutexLocked(ИмяБлок,аПольз,аМаш,аДата)=2 Then
-   Message("Обмен с с центральной базой уже выполняет пользователь "+аПольз+" ("+аМаш+"), начало "+аДата+"! Дождитесь окончания предыдущего обмена!","!");
+   Message("Обмен с центральной базой уже выполняет пользователь "+аПольз+" ("+аМаш+"), начало "+аДата+"! Дождитесь окончания предыдущего обмена!","!");
 Else
    Message("В данный момент обмен с центральной базой не выполняется!");
 EndIf;
 </pre>

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