Допускает Временное Разъединение Соединения или соединений, установленных с источниками данных при помощи функций SQL pass-through.
SQLIDLEDISCONNECT(nStatementHandle) |
Параметры
- nStatementHandle
-
Определяет дескриптор (handle) соединения с источником данных, которое временно деактивируется.
Можно задать значение = 0, для временной деактивации всех активных Соединений.
Возвращаемое значение
Числового типа.
Возвращается значение = 1, если успешно выполнена Временная Деактивация соединения (соединений), установленных ранее с помощью функций SQL pass-through.
Возвращается значение = -1, если невозможно выполнить деактивацию соединения с помощью функции SQLIDLEDISCONNECT( ).
Комментарии
Данная функция завершается аварийно (возвращает = -1), если указанное в параметре соединение Занято или переведено в в режим manual commit. См. дополнительно об использовании AERROR( ), функция - для определения дополнительной информации о причинах занятости указанного соединения.
Временно Деактивированные соединения автоматически восстанавливаются, как только это потребуется (при выполнении операций с Источником Данных); используются параметры соединения, которые использовались при начальной установке Соединения. Свойство Провайдера ODBC ODBChstmt = 0, если выполнено временное разединение с источником данных, по указанному дескриптору Соединения. Данное свойство также = 0, для Временно деактивированных Соединений. Если рассматриваемое Соединение установлено в режим коллективного использования (shared), то при временной деактивации с помощью данной функции, освобождаются все Дескрипторы соответствующих Соединений (коллективно используемых).