Функция SQLDisconnect
соответствие
Представлена версия: соответствие стандартам ODBC 1.0: ISO 92
Сводка
SQLDisconnect закрывает соединение, связанное с определенным дескриптором подключения.
Синтаксис
SQLRETURN SQLDisconnect(
SQLHDBC ConnectionHandle);
Аргументы
ConnectionHandle
[Входные данные] Дескриптор подключения.
Возвращает
SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR, SQL_INVALID_HANDLE или SQL_STILL_EXECUTING.
Диагностика
Если SQLDisconnect возвращает SQL_ERROR или SQL_SUCCESS_WITH_INFO, связанное значение SQLSTATE можно получить путем вызова SQLGetDiagRec с HandleType SQL_HANDLE_DBC и HandleConnectionHandle. В следующей таблице перечислены значения SQLSTATE, которые обычно возвращаются SQLDisconnect и объясняются каждый из них в контексте этой функции; Нотация "(DM)" предшествует описаниям SQLSTATEs, возвращаемым диспетчером драйверов. Возвращаемый код, связанный с каждым значением SQLSTATE, SQL_ERROR, если не указано иное.
| SQLSTATE | Ошибка | Описание |
|---|---|---|
| 01000 | Общее предупреждение | Информационное сообщение для конкретного драйвера. (Функция возвращает SQL_SUCCESS_WITH_INFO.) |
| 01002 | Ошибка отключения | Произошла ошибка во время отключения. Однако отключение выполнено успешно. (Функция возвращает SQL_SUCCESS_WITH_INFO.) |
| 08003 | Подключение не открыто | (DM) Подключение, указанное в аргументе ConnectionHandle, не было открыто. |
| 25000 | Недопустимое состояние транзакции | Транзакция была в процессе подключения, указанного аргументом ConnectionHandle. Транзакция остается активной. |
| HY000 | Общая ошибка | Произошла ошибка, для которой не было определенного SQLSTATE и для которого не было определено значение SQLSTATE для конкретной реализации. Сообщение об ошибке, возвращаемое SQLGetDiagRec в буфере *MessageText описывает ошибку и ее причину. |
| HY001 | Ошибка выделения памяти | Драйверу не удалось выделить память, необходимую для поддержки выполнения или завершения функции. |
| HY008 | Операция отменена | Асинхронная обработка была включена для ConnectionHandle. Функция была вызвана и до завершения выполнения функции SQLCancelHandle была вызвана ConnectionHandle. Затем функция была вызвана снова на ConnectionHandle. Функция была вызвана и до завершения выполнения SQLCancelHandle была вызвана ConnectionHandle из другого потока в многопотоковом приложении. |
| HY010 | Ошибка последовательности функций | (DM) Асинхронно выполняющаяся функция была вызвана для StatementHandle, связанной с ConnectionHandle и по-прежнему выполнялась при вызове SQLDisconnect. (DM) асинхронно выполняющаяся функция (не эта) была вызвана для ConnectionHandle и по-прежнему выполнялась при вызове этой функции. (DM) SQLExecute, SQLExecDirect, SQLBulkOperationsили SQLSetPos вызывается для StatementHandle, связанной с ConnectionHandle и возвращенной SQL_NEED_DATA. Эта функция была вызвана до отправки данных для всех параметров выполнения или столбцов. |
| HY013 | Ошибка управления памятью | Не удалось обработать вызов функции, так как к базовым объектам памяти не удалось получить доступ, возможно, из-за низкой памяти. |
| HY117 | Подключение приостановлено из-за неизвестного состояния транзакции. Разрешены только функции отключения и только для чтения. | (DM) Дополнительные сведения о приостановленном состоянии см. в функции SQLEndTran. |
| HYT01 | Истек срок действия времени ожидания подключения | Срок ожидания подключения истек до того, как источник данных ответил на запрос, и подключение по-прежнему активно. Период времени ожидания подключения задается через SQLSetConnectAttrSQL_ATTR_CONNECTION_TIMEOUT. |
| IM001 | Драйвер не поддерживает эту функцию | (DM) Драйвер, связанный с ConnectionHandle, не поддерживает функцию. |
| IM017 | Опрос отключен в асинхронном режиме уведомлений | При использовании модели уведомлений опрос отключается. |
| IM018 | SQLCompleteAsync не был вызван для выполнения предыдущей асинхронной операции в этом дескрипторе. | Если предыдущий вызов функции дескриптора возвращает SQL_STILL_EXECUTING и если включен режим уведомлений, SQLCompleteAsync необходимо вызвать на дескриптор, чтобы выполнить после обработки и завершить операцию. |
Комментарии
Если приложение вызывает SQLDisconnect после SQLBrowseConnect возвращает SQL_NEED_DATA и перед возвратом другого возвращаемого кода драйвер отменяет процесс просмотра подключений и возвращает подключение к несоединённому состоянию.
Если приложение вызывает SQLDisconnect при наличии неполной транзакции, связанной с дескриптором подключения, драйвер возвращает SQLSTATE 25000 (недопустимое состояние транзакции), указывая, что транзакция не изменяется и подключение открыто. Неполная транзакция — это транзакция, которая не была зафиксирована или откатена с помощью SQLEndTran.
Если приложение вызывает SQLDisconnect до освобождения всех инструкций, связанных с подключением, драйвер после успешного отключения от источника данных освобождает эти инструкции и все дескрипторы, которые были явно выделены для подключения. Однако если одна или несколько инструкций, связанных с подключением, по-прежнему выполняются асинхронно, SQLDisconnect возвращает SQL_ERROR со значением HY010 (ошибка последовательности функций). Кроме того, SQLDisconnect освобождает все связанные инструкции и все дескрипторы, которые были явно выделены для подключения, если подключение находится в приостановленном состоянии или если SQLDisconnect успешно отменены SQLCancelHandle.
Сведения о том, как приложение использует SQLDisconnect, см. в отключении от источника данных или драйвера.
Отключение от подключения в пуле
Если пул подключений включен для общей среды и вызовы приложений SQLDisconnect в этой среде, подключение возвращается к пулу подключений и по-прежнему доступно другим компонентам с использованием той же общей среды.
Пример кода
См. пример программы ODBC, функции SQLBrowseConnectи функции SQLConnect.
Связанные функции
| Сведения о | Видеть |
|---|---|
| Выделение дескриптора | функции SQLAllocHandle |
| Подключение к источнику данных | функции SQLConnect |
| Подключение к источнику данных с помощью строки подключения или диалогового окна | функция SQLDriverConnect |
| Выполнение операции фиксации или отката | функция SQLEndTran |
| Освобождение дескриптора подключения | функция SQLFreeConnect |
См. также
Справочник по API ODBC
файлы заголовков ODBC