Допускает Временное Разъединение Соединения или соединений, установленных с источниками данных при помощи функций SQL pass-through.

SQLIDLEDISCONNECT(nStatementHandle)

Параметры

nStatementHandle

Определяет дескриптор (handle) соединения с источником данных, которое временно деактивируется.

Можно задать значение =  0, для временной деактивации всех активных Соединений.

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

Числового типа.

Возвращается значение = 1, если успешно выполнена Временная Деактивация соединения (соединений), установленных ранее с помощью функций SQL pass-through.

Возвращается значение = -1, если невозможно выполнить деактивацию соединения с помощью функции SQLIDLEDISCONNECT( ).

Expand imageКомментарии

Данная функция завершается аварийно  (возвращает = -1), если указанное в параметре соединение Занято или переведено в в режим manual commit. См. дополнительно об использовании  AERROR( ), функция  - для определения дополнительной информации о причинах занятости указанного соединения.

Временно Деактивированные соединения автоматически восстанавливаются, как только это потребуется (при выполнении операций с Источником Данных); используются параметры соединения, которые использовались при начальной установке Соединения. Свойство Провайдера ODBC ODBChstmt = 0, если выполнено временное разединение с источником данных, по указанному дескриптору Соединения. Данное свойство также = 0, для Временно деактивированных Соединений.  Если рассматриваемое Соединение установлено в режим коллективного использования (shared), то при временной деактивации с помощью данной функции, освобождаются все Дескрипторы соответствующих Соединений (коллективно используемых).

Expand imageСм. также