Функция КОЛ_БЛОК_ОБЪЕКТ
Для работы требуется соединение с базой данных.
Функция КОЛ_БЛОК_ОБЪЕКТ позволяет определить, установлена ли логическая блокировка на объект с заданным кодом. Если объект блокировался текущим клиентом, то функция возвращает значение счетчика блокировок (сколько раз блокировался).
ФУНКЦИЯ ЦЕЛОЕ: КОЛ_БЛОК_ОБЪЕКТ(СТРОКА: код)
Параметры
- код
- Абсолютный код объекта.
Возвращаемое значение
Возможны следующие варианты:
| 0 | – | объект не блокируется ни текущим, ни другим клиентом; |
| >0 | – | объект заблокирован текущим клиентом соответствующее количество раз; |
| -1 | – | объект заблокирован другим клиентом; |
| -2 | – | ошибка вызова функции (например, сбой в сети), подробности можно узнать с помощью функции ПОСЛ_ОШИБКА. |
Замечания:
- Функция ЕСТЬ_БЛОК_ОБЪЕКТ возвращает ДА, когда КОЛ_БЛОК_ОБЪЕКТ возвращает –1.
- Для объектов не последнего уровня возможна ситуация, когда блокируется один или несколько нижележащих в иерархии объектов, а не они сами. В этом случае счетчик блокировок для объектов не последнего уровня будет равен 0, но установить блокировку на них будет нельзя, а функция ЕСТЬ_БЛОК_ОБЪЕКТ вернет ДА. Такая блокировка распространяется на все объекты вверх по иерархии, вплоть до объектов верхнего уровня.