Закрывает Соединение с удаленным источником Данных.

SQLDISCONNECT(nStatementHandle)

Параметры

nStatementHandle

Определяет номер Дескриптора Соединения с удаленным источником данных, который возвращается функцией SQLCONNECT( ). Если задается значение = 0, для параметра nStatementHandle, то закрываются все открытые-активные Соединения.

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

Числового типа. SQLDISCONNECT( ) возвращает значение = 1, если успешно выполнено закрытие указанного Соединения; если возвращается значение = – 1, то произошла ошибка уровня Соединения; если возвращается значение = – 2, то произошла ошибка уровня Окружения (ODBC).

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

SQLDISCONNECT( ) закрывает Соединение с удаленным источником Данных. Вы должны указать номер Дескриптора Соединения, который получен ранее при помощи функции SQLCONNECT( ), в момент установки (открытия) Соединения с удаленным источником данных.

NoteПримечание

Если вы выполняете функцию SQLDISCONNECT( ) при активном режиме асинхронного выполнения SQL-запроса или незавершенной Транзакции изменения данных, то данная функция SQLDISCONNECT( ) генерирует сообщение об Ошибке, Соединение не закрывается, прооцесс занят.

Expand imageПример

В следующем примере предполагается установка Соединения (ODBC) с удаленным источником данных MyFoxSQLNT. SQLCONNECT( ) уже выполнена, номер дескриптора соединения сохранен в переменной памяти с именем gnHandle.

Если успешно выполена попытка установки соединения с удаленным источником данных, SQLCONNECT( ) возвращает положительное число, выводится диалоговый бокс, сообщающий об установленном соединении; далее используется функция SQLDISCONNECT( ) - для закрытия установленного соединения.

Если попытка соединения с источником данных завершилась аварийно, SQLCONNECT( ) возвращает отрицательное число, выводится соответствующий диалоговый бокс, сообщающий о невозможности установить соединение с удаленным источником данных.

  CopyCode imageКопировать Код
STORE SQLCONNECT('MyFoxSQLNT', '<userid>', '<password>') TO gnHandle
IF gnHandle <= 0
   = MESSAGEBOX('Cannot make connection', 16, 'SQL Connect Error')
ELSE
   = MESSAGEBOX('Connection made', 48, 'SQL Connect Message)
   = SQLDISCONNECT(gnHandle)
ENDIF

Expand imageСм. также