Spec-Zone .ru
спецификации, руководства, описания, API
|
Этот раздел суммирует подпрограммы ODBC, категоризированные функциональностью.
Для полной ссылки API ODBC, пожалуйста, сошлитесь на Справочник программиста ODBC в
Приложение может вызвать SQLGetInfo
функция, чтобы получить информацию о
соответствии о Соединителе/ODBC. Чтобы получить информацию о поддержке определенной функции в драйвере,
приложение может вызвать SQLGetFunctions
.
Для обратной совместимости драйвер Соединителя/ODBC поддерживает все осуждаемые функции.
Следующие таблицы приводят вызовы API Соединителя/ODBC, сгруппированные задачей:
Таблица 22.6. Вызовы API ODBC Соединения с Источником данных
Имя функции | Соединитель/ODBC Поддерживает? | Стандарт | Цель |
---|---|---|---|
SQLAllocHandle |
Да | ISO 92 | Получает среду, соединение, оператор, или дескриптор дескриптора. |
SQLConnect |
Да | ISO 92 | Соединяется с определенным драйвером именем источника данных, идентификатором пользователя, и паролем. |
SQLDriverConnect |
Да | ODBC | Соединяется с определенным драйвером строкой подключения или запрашивает, чтобы менеджер по Драйверу и драйвер вывели на экран соединение dialogboxes для пользователя. |
SQLAllocEnv |
Да | Осуждаемый | Получает дескриптор среды, выделенный из драйвера. |
SQLAllocConnect |
Да | Осуждаемый | Получает дескриптор соединения |
Таблица 22.7. Вызовы API ODBC Получения информации о Драйвере и Источнике данных
Имя функции | Соединитель/ODBC Поддерживает? | Стандарт | Цель |
---|---|---|---|
SQLDataSources |
Нет | ISO 92 | Возвращает список доступных источников данных, обработанных менеджером по Драйверу |
SQLDrivers |
Нет | ODBC | Возвращает список установленных драйверов и их атрибутов, обрабатывает byDriver менеджера |
SQLGetInfo |
Да | ISO 92 | Информация о возвратах об определенном драйвере и источнике данных. |
SQLGetFunctions |
Да | ISO 92 | Возвраты поддерживаемые функции драйвера. |
SQLGetTypeInfo |
Да | ISO 92 | Информация о возвратах о поддерживаемых типах данных. |
Таблица 22.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 |
Да | Осуждаемый | Возвращает значение опции оператора |
Таблица 22.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 | Опции наборов то поведение курсора управления. |
Таблица 22.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 | Отправляет часть или все значение данных для параметра. (Полезный для долгих значений данных.) |
Таблица 22.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 | Выполняет объемные вставки, и объемные операции закладки, включая обновление, удаляют, и выборка закладкой. |
Таблица 22.12. Вызовы API ODBC Получения Ошибки или Диагностической информации
Имя функции | Соединитель/ODBC Поддерживает? | Стандарт | Цель |
---|---|---|---|
SQLError |
Да | Осуждаемый | Возвращает дополнительную ошибку или информацию о статусе |
SQLGetDiagField |
Да | ISO 92 | Возвращает дополнительную диагностическую информацию (единственное поле диагностической структуры данных). |
SQLGetDiagRec |
Да | ISO 92 | Возвращает дополнительную диагностическую информацию (многократные поля thediagnostic структуры данных). |
Таблица 22.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 | Возвращает список имен таблиц, сохраненных в определенном источнике данных. |
Таблица 22.14. Вызовы API ODBC Выполнения Транзакций
Имя функции | Соединитель/ODBC Поддерживает? | Стандарт | Цель |
---|---|---|---|
SQLTransact |
Да | Осуждаемый | Фиксации или откатывают транзакцию |
SQLEndTran |
Да | ISO 92 | Фиксации или откатывают atransaction. |
Таблица 22.15. Вызовы API ODBC Завершения Оператора
Имя функции | Соединитель/ODBC Поддерживает? | Стандарт | Цель |
---|---|---|---|
SQLFreeStmt |
Да | ISO 92 | Обработка оператора концов, отбрасывания, ожидающие результаты, и, дополнительно, освобождает все ресурсы, связанные с statementhandle. |
SQLCloseCursor |
Да | ISO 92 | Закрывает курсор, который был открыт на дескрипторе оператора. |
SQLCancel |
Да | ISO 92 | Отменяет SQL-оператор. |
Таблица 22.16. Вызовы API ODBC Завершения Соединения
Имя функции | Соединитель/ODBC Поддерживает? | Стандарт | Цель |
---|---|---|---|
SQLDisconnect |
Да | ISO 92 | Закрывает соединение. |
SQLFreeHandle |
Да | ISO 92 | Выпускает среду, соединение, оператор, или дескриптор дескриптора. |
SQLFreeConnect |
Да | Осуждаемый | Дескриптор соединения выпусков. |
SQLFreeEnv |
Да | Осуждаемый | Выпускает дескриптор среды. |