Операционная система ЗОСРВ «Нейтрино» > Руководство разработчика > Программные интерфейсы общего назначения > Прикладные библиотеки и технологии > Библиотека менеджера QDB > Справочник по клиентскому API менеджера QDB > qdb_gettransstate()

qdb_gettransstate()

Получение состояния соединения с базой данных

Прототип:

#include <qdb/qdb.h>
                                       
int qdb_gettransstate( qdb_hdl_t *hdl );

Аргументы:

hdl: Указатель на дескриптор базы данных.

Функция позволяет получить состояние соединения с базой данных. Если соединение имеет активную SQL транзакцию, функция возвращает 1 и 0 в противном случае. -1 означает наличие ошибки в соединении (см. qdb_geterrmsg()).

Данная функция может использоваться для определения способа восстановления после ошибки. Так, например, если выполняется несколько команд, включая транзакцию, появляется возможность определения оператор, вызвавшего сбой.

Возвращаемое значение:

=0: Отсутствуют SQL транзакции в процессе исполнения.
≥1: SQL транзакция в процессе исполнения.
-1: Возникла ошибка. Код ошибки записан в errno.

Классификация:

ЗОСРВ «Нейтрино»

Безопасность использования
Обработчик прерываний: Нет
Обработчик сигналов: Нет
В потоке: Да

Тематические ссылки:

qdb_geterrmsg()

Предыдущий раздел: перейти