Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Область применения:
SQL ServerБаза данных SQL AzureУправляемый экземпляр SQL Azure
Это важно
Эта функция будет удалена в будущей версии Windows. Избегайте использования этой функции в новых разработках и планируйте изменять приложения, в которых используется эта функция в настоящее время. Корпорация Майкрософт рекомендует использовать функции курсора драйвера.
Библиотека курсоров ODBC поддерживает прокручиваемые курсоры для драйверов ODBC 2.x, которые поддерживают только курсоры только для перенаправления. Если включить библиотеку курсоров для подключения, диспетчер драйверов перехватывает вызовы функций и направляет их через библиотеку курсоров, а не непосредственно в драйвер. Библиотека курсоров выполняет саму функцию или передает ее базовому драйверу.
Функции, выполняемые библиотекой курсоров
В этих статьях описывается, какие функции ODBC выполняют дескриптор библиотеки курсоров и которые передаются драйверу.
| Article | Description |
|---|---|
| Функции ODBC, выполняемые библиотекой курсоров | Перечисляет функции, реализуемые библиотекой курсоров, для предоставления функции прокрутки курсора. |
| Функции ODBC, не выполняемые библиотекой курсоров | Выводит список функций, которые библиотека курсоров передает драйверу без изменений. |
Привязка столбцов и параметров
Эти функции обрабатывают буферы приложений привязки к результирующих столбцам и параметрам инструкции. Библиотека курсоров изменяет их поведение для поддержки позиционированных обновлений и блокировок курсоров.
| Функция | Description |
|---|---|
| SQLBindCol (библиотека курсоров) | Привязывает буферы приложений к столбцам результирующего набора. Библиотека курсоров отслеживает привязки для поддержки операций с размещением обновлений и удаления. |
| SQLBindParameter (библиотека курсоров) | Привязывает буферы приложения к маркерам параметров. Библиотека курсоров передает этот вызов драйверу. |
Массовые и позиционированные операции
Эти функции выполняют массовые операции с наборами строк и размещением обновлений отдельных строк в текущем наборе строк курсора.
| Функция | Description |
|---|---|
| SQLBulkOperations (библиотека курсоров) | Выполняет массовую вставку, обновление, удаление или получение операций закладки. Библиотека курсоров сопоставляется с этим SQLSetPos при работе с драйверами ODBC 2.x. |
| SQLSetPos (библиотека курсоров) | Помещает курсор в набор строк и позволяет приложениям обновлять, обновлять или удалять данные в наборе строк. |
Управление курсорами и транзакции
Эти функции управляют временем существования курсора и границами транзакций.
| Функция | Description |
|---|---|
| SQLCloseCursor (библиотека курсоров) | Закрывает курсор в инструкции и удаляет ожидающие результаты. |
| SQLEndTran (библиотека курсоров) | Фиксирует или откатывает транзакцию. Библиотека курсоров управляет состоянием курсора через границы транзакций на SQL_CURSOR_COMMIT_BEHAVIOR основе параметров и SQL_CURSOR_ROLLBACK_BEHAVIOR параметров. |
| SQLFreeStmt (библиотека курсоров) | Останавливает обработку инструкций, закрывает любой связанный курсор, удаляет ожидающие результаты и при необходимости освобождает все ресурсы, связанные с дескриптором инструкции. |
Извлечение данных
Эти функции извлекает данные из результирующих наборов. Библиотека курсоров предоставляет функции прокрутки курсоров для драйверов, которые поддерживают только курсоры, доступные только для перенаправления.
| Функция | Description |
|---|---|
| SQLFetch (библиотека курсоров) | Извлекает следующий набор строк данных из результирующий набор. При работе с драйверами ODBC 2.x библиотека курсоров сопоставляет это с SQLExtendedFetch. |
| SQLFetchScroll (библиотека курсоров) | Извлекает указанный набор строк данных из результирующего набора и возвращает данные для всех привязанных столбцов. Поддерживает различные направления прокрутки, включая первый, последний, следующий, предыдущий, абсолютный и относительный позиционирование. |
| SQLExtendedFetch (библиотека курсоров) | Извлекает указанный набор строк из результирующий набор. Эта функция устарела в ODBC 3.x; вместо этого используйте SQLFetchScroll . |
| SQLGetData (библиотека курсоров) | Извлекает данные для одного столбца в результирующем наборе после SQLFetch или SQLFetchScroll вызывается. |
Дескрипторные операции
Эти функции получают и задают значения полей дескриптора. Дескрипторы определяют атрибуты параметров и столбцов результирующего набора.
| Функция | Description |
|---|---|
| SQLGetDescField и SQLGetDescRec (библиотека курсоров) | Получение отдельных значений полей или полных записей дескриптора. Библиотека курсоров обрабатывает их для внутренних дескрипторов. |
| SQLSetDescField и SQLSetDescRec (библиотека курсоров) | Задайте отдельные значения полей или полные записи дескриптора. Библиотека курсоров отслеживает изменения полей дескриптора. |
Запросы возможностей драйвера
Эти функции возвращают сведения о возможностях библиотеки драйверов и курсоров.
| Функция | Description |
|---|---|
| SQLGetFunctions (библиотека курсоров) | Возвращает сведения о том, какие функции ODBC поддерживают драйвер. Библиотека курсоров изменяет ответ для включения функций, которые он реализует. |
| SQLGetInfo (библиотека курсоров) | Возвращает общие сведения об драйвере и источнике данных. Библиотека курсоров изменяет определенные типы информации, связанные с курсором, чтобы отразить ее возможности. |
Атрибуты инструкции и подключения
Эти функции получают и задают операторы, подключения и атрибуты среды, влияющие на поведение курсора.
| Функция | Description |
|---|---|
| SQLGetStmtAttr (библиотека курсоров) | Возвращает текущее значение атрибута оператора. Библиотека курсоров обрабатывает атрибуты, связанные с поведением курсора. |
| SQLGetStmtOption (библиотека курсоров) | Возвращает значения параметра оператора. Эта функция устарела в ODBC 3.x; вместо этого используйте SQLGetStmtAttr . |
| SQLSetStmtAttr (библиотека курсоров) | Задает атрибут оператора. Библиотека курсоров обрабатывает атрибуты, связанные с курсором, для реализации поддержки прокручиваемых курсоров. |
| SQLSetScrollOptions (библиотека курсоров) | Задает параметры, управляющие поведением курсора. Эта функция устарела в ODBC 3.x; вместо этого используйте SQLSetStmtAttr атрибуты, связанные с курсором. |
| SQLSetConnectAttr (библиотека курсоров) | Задает атрибут подключения. Библиотека курсоров обрабатывает SQL_ATTR_ODBC_CURSORS атрибут для включения или отключения использования библиотеки курсоров. |
| SQLSetEnvAttr (библиотека курсоров) | Задает атрибут среды. Библиотека курсоров передает этот вызов диспетчеру драйверов. |
Операции перевода и строк SQL
Эти функции обрабатывают преобразование инструкций SQL и получение количества строк.
| Функция | Description |
|---|---|
| SQLNativeSql (библиотека курсоров) | Возвращает строку SQL, измененную драйвером. Библиотека курсоров передает этот вызов драйверу без изменений. |
| SQLRowCount (библиотека курсоров) | Возвращает количество строк, затронутых инструкцией UPDATE, INSERT или DELETE. Библиотека курсоров отслеживает количество строк для операций с размещением обновлений и удаления. |