SQLBindCol (библиотека курсоров)

Внимание

Эта функция будет удалена в будущей версии Windows. Избегайте использования этой функции в новых рабочих областях разработки и планируете изменять приложения, которые в настоящее время используют эту функцию. Корпорация Майкрософт рекомендует использовать функции курсора драйвера.

В этом разделе рассматривается использование функции SQLBindCol в библиотеке курсоров. Общие сведения о SQLBindCol см. в разделе "Функция SQLBindCol".

Приложение выделяет один или несколько буферов для библиотеки курсоров, чтобы вернуть текущий набор строк. Он вызывает SQLBindCol один или несколько раз, чтобы привязать эти буферы к результирующем набору.

Приложение может вызвать SQLBindCol для повторной привязки столбцов результирующего набора после вызова SQLExtendedFetch, SQLFetch или SQLFetchScroll, если тип данных C, размер столбца и десятичные цифры привязанного столбца остаются неизменными. Приложению не нужно закрывать курсор для повторной привязки столбцов к разным адресам.

Библиотека курсоров поддерживает настройку атрибута инструкции SQL_ATTR_ROW_BIND_OFFSET_PTR для использования смещения привязки. (SQLBindCol не требуется вызывать для этого повторного связывания.) Если библиотека курсоров используется с драйвером ODBC 3.x , смещение привязки не используется при вызове SQLFetch . Смещение привязки используется, если sqlFetch вызывается при использовании библиотеки курсоров с драйвером ODBC 2.x , так как sqlFetch затем сопоставляется с SQLExtendedFetch.

Библиотека курсоров поддерживает вызов SQLBindCol для привязки столбца закладки.

При работе с драйвером ODBC 2.x библиотека курсоров возвращает SQLSTATE HY090 (недопустимая строка или длина буфера) при вызове SQLBindCol , чтобы задать длину буфера для столбца закладки значением, не равным 4. При работе с драйвером ODBC 3.x библиотека курсоров позволяет буферу иметь любой размер.