Spec-Zone .ru
спецификации, руководства, описания, API

21.1.6.1. Ссылка API соединителя/ODBC

Этот раздел суммирует подпрограммы ODBC, категоризированные функциональностью.

Для полной ссылки API ODBC, пожалуйста, сошлитесь на Справочник программиста ODBC в http://msdn.microsoft.com/en-us/library/ms714177.aspx.

Приложение может вызвать SQLGetInfo функция, чтобы получить информацию о соответствии о Соединителе/ODBC. Чтобы получить информацию о поддержке определенной функции в драйвере, приложение может вызвать SQLGetFunctions.

Отметить

Для обратной совместимости драйвер Соединителя/ODBC поддерживает все осуждаемые функции.

Следующие таблицы приводят вызовы API Соединителя/ODBC, сгруппированные задачей:

Таблица 21.6. Вызовы API ODBC Соединения с Источником данных

Имя функции Соединитель/ODBC Поддерживает? Стандарт Цель
SQLAllocHandle Да ISO 92 Получает среду, соединение, оператор, или дескриптор дескриптора.
SQLConnect Да ISO 92 Соединяется с определенным драйвером именем источника данных, идентификатором пользователя, и паролем.
SQLDriverConnect Да ODBC Соединяется с определенным драйвером строкой подключения или запрашивает, чтобы менеджер по Драйверу и драйвер вывели на экран соединение dialogboxes для пользователя.
SQLAllocEnv Да Осуждаемый Получает дескриптор среды, выделенный из драйвера.
SQLAllocConnect Да Осуждаемый Получает дескриптор соединения

Таблица 21.7. Вызовы API ODBC Получения информации о Драйвере и Источнике данных

Имя функции Соединитель/ODBC Поддерживает? Стандарт Цель
SQLDataSources Нет ISO 92 Возвращает список доступных источников данных, обработанных менеджером по Драйверу
SQLDrivers Нет ODBC Возвращает список установленных драйверов и их атрибутов, обрабатывает byDriver менеджера
SQLGetInfo Да ISO 92 Информация о возвратах об определенном драйвере и источнике данных.
SQLGetFunctions Да ISO 92 Возвраты поддерживаемые функции драйвера.
SQLGetTypeInfo Да ISO 92 Информация о возвратах о поддерживаемых типах данных.

Таблица 21.8. Вызовы API ODBC Установки и Получения Атрибутов Драйвера

Имя функции Соединитель/ODBC Поддерживает? Стандарт Цель
SQLSetConnectAttr Да ISO 92 Устанавливает атрибут соединения.
SQLGetConnectAttr Да ISO 92 Возвращает значение атрибута соединения.
SQLSetConnectOption Да Осуждаемый Устанавливает опцию соединения
SQLGetConnectOption Да Осуждаемый Возвращает значение опции соединения
SQLSetEnvAttr Да ISO 92 Устанавливает атрибут среды.
SQLGetEnvAttr Да ISO 92 Возвращает значение атрибута среды.
SQLSetStmtAttr Да ISO 92 Устанавливает атрибут оператора.
SQLGetStmtAttr Да ISO 92 Возвращает значение атрибута оператора.
SQLSetStmtOption Да Осуждаемый Устанавливает опцию оператора
SQLGetStmtOption Да Осуждаемый Возвращает значение опции оператора

Таблица 21.9. Вызовы API ODBC Подготовки Запросов SQL

Имя функции Соединитель/ODBC Поддерживает? Стандарт Цель
SQLAllocStmt Да Осуждаемый Выделяет дескриптор оператора
SQLPrepare Да ISO 92 Готовит SQL-оператор к более позднему выполнению.
SQLBindParameter Да ODBC Присваивает хранение для параметра в SQL-операторе. Соединитель/ODBC 5.2 добавляет поддержку и "inout" параметры, через SQL_PARAM_OUTPUT или SQL_PARAM_INPUT_OUTPUT введите спецификаторы. (И "inout" параметры не поддерживаются для LONGTEXT иLONGBLOB столбцы.)
SQLGetCursorName Да ISO 92 Возвращает имя курсора, связанное с дескриптором оператора.
SQLSetCursorName Да ISO 92 Определяет имя курсора.
SQLSetScrollOptions Да ODBC Опции наборов то поведение курсора управления.

Таблица 21.10. Вызовы API ODBC Передачи Запросов

Имя функции Соединитель/ODBC Поддерживает? Стандарт Цель
SQLExecute Да ISO 92 Выполняет готовый оператор.
SQLExecDirect Да ISO 92 Выполняет оператор
SQLNativeSql Да ODBC Возвращает текст SQL-оператора как преобразовано драйвером.
SQLDescribeParam Да ODBC Возвращает описание для определенного параметра в операторе.
SQLNumParams Да ISO 92 Возвращает число параметров в операторе.
SQLParamData Да ISO 92 Используемый в соединении с SQLPutData снабжать данными параметра во время выполнения. (Полезный для долгих значений данных.)
SQLPutData Да ISO 92 Отправляет часть или все значение данных для параметра. (Полезный для долгих значений данных.)

Таблица 21.11. Вызовы API ODBC Получения Результатов и информации о Результатах

Имя функции Соединитель/ODBC Поддерживает? Стандарт Цель
SQLRowCount Да ISO 92 Возвращает число строк, на которые влияет вставка, обновление, или удалите запрос.
SQLNumResultCols Да ISO 92 Возвращает число столбцов в наборе результатов.
SQLDescribeCol Да ISO 92 Описывает столбец в наборе результатов.
SQLColAttribute Да ISO 92 Описывает атрибуты столбца в наборе результатов.
SQLColAttributes Да Осуждаемый Описывает атрибуты столбца в наборе результатов.
SQLFetch Да ISO 92 Возвраты многократные строки результата.
SQLFetchScroll Да ISO 92 Возвращает строки результата с возможностью прокрутки.
SQLExtendedFetch Да Осуждаемый Возвращает строки результата с возможностью прокрутки.
SQLSetPos Да ODBC Располагает курсор в пределах выбранного блока данных и позволяет приложению обновить данные в наборе строк или обновить или удалить данные в наборе результатов.
SQLBulkOperations Да ODBC Выполняет объемные вставки, и объемные операции закладки, включая обновление, удаляют, и выборка закладкой.

Таблица 21.12. Вызовы API ODBC Получения Ошибки или Диагностической информации

Имя функции Соединитель/ODBC Поддерживает? Стандарт Цель
SQLError Да Осуждаемый Возвращает дополнительную ошибку или информацию о статусе
SQLGetDiagField Да ISO 92 Возвращает дополнительную диагностическую информацию (единственное поле диагностической структуры данных).
SQLGetDiagRec Да ISO 92 Возвращает дополнительную диагностическую информацию (многократные поля thediagnostic структуры данных).

Таблица 21.13. Вызовы API ODBC Получения информации о SystemTables Источника данных (Функции Каталога) Элемент

Имя функции Соединитель/ODBC Поддерживает? Стандарт Цель
SQLColumnPrivileges Да ODBC Возвращает список столбцов и связанных полномочий для одной или более таблиц.
SQLColumns Да X/Open Возвращает список имен столбцов в указанных таблицах.
SQLForeignKeys Да ODBC Возвращает список имен столбцов, которые составляют внешние ключи, если они существуют для указанной таблицы.
SQLPrimaryKeys Да ODBC Возвращает список имен столбцов, которые составляют первичный ключ для таблицы.
SQLSpecialColumns Да X/Open Информация о возвратах об оптимальном наборе столбцов, который однозначно определяет строку в указанной таблице, или столбцы, которые автоматически обновляются, когда любое значение в строке обновляется транзакцией.
SQLStatistics Да ISO 92 Статистика возвратов о единственной таблице и списке indexesassociated с таблицей.
SQLTablePrivileges Да ODBC Возвращает список таблиц и полномочий, связанных с каждой таблицей.
SQLTables Да X/Open Возвращает список имен таблиц, сохраненных в определенном источнике данных.

Таблица 21.14. Вызовы API ODBC Выполнения Транзакций

Имя функции Соединитель/ODBC Поддерживает? Стандарт Цель
SQLTransact Да Осуждаемый Фиксации или откатывают транзакцию
SQLEndTran Да ISO 92 Фиксации или откатывают atransaction.

Таблица 21.15. Вызовы API ODBC Завершения Оператора

Имя функции Соединитель/ODBC Поддерживает? Стандарт Цель
SQLFreeStmt Да ISO 92 Обработка оператора концов, отбрасывания, ожидающие результаты, и, дополнительно, освобождает все ресурсы, связанные с statementhandle.
SQLCloseCursor Да ISO 92 Закрывает курсор, который был открыт на дескрипторе оператора.
SQLCancel Да ISO 92 Отменяет SQL-оператор.

Таблица 21.16. Вызовы API ODBC Завершения Соединения

Имя функции Соединитель/ODBC Поддерживает? Стандарт Цель
SQLDisconnect Да ISO 92 Закрывает соединение.
SQLFreeHandle Да ISO 92 Выпускает среду, соединение, оператор, или дескриптор дескриптора.
SQLFreeConnect Да Осуждаемый Дескриптор соединения выпусков.
SQLFreeEnv Да Осуждаемый Выпускает дескриптор среды.