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

Внимание

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

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

Библиотека курсоров поддерживает следующие атрибуты инструкции с помощью SQLSetStmtAttr:

SQL_ATTR_CONCURRENCY
SQL_ATTR_CURSOR_TYPE
SQL_ATTR_FETCH_BOOKMARK_PTR
SQL_ATTR_PARAM_BIND_OFFSET_PTR
SQL_ATTR_PARAM_BIND_TYPE

SQL_ATTR_ROW_BIND_OFFSET_PTR
SQL_ATTR_ROW_BIND_TYPE
SQL_ATTR_ROWSET_ARRAY_SIZE
SQL_ATTR_SIMULATE_CURSOR
SQL_ATTR_USE_BOOKMARKS

Библиотека курсоров поддерживает только значения SQL_CURSOR_FORWARD_ONLY и SQL_CURSOR_STATIC атрибута инструкции SQL_ATTR_CURSOR_TYPE.

Для курсоров, доступных только для пересылки, библиотека курсоров поддерживает значение SQL_CONCUR_READ_ONLY атрибута инструкции SQL_ATTR_CONCURRENCY. Для статических курсоров библиотека курсоров поддерживает значения SQL_CONCUR_READ_ONLY и SQL_CONCUR_VALUES атрибута инструкции SQL_ATTR_CONCURRENCY.

Библиотека курсоров поддерживает только SQL_SC_NON_UNIQUE значение атрибута инструкции SQL_ATTR_SIMULATE_CURSOR.

Хотя спецификация ODBC поддерживает вызовы SQLSetStmtAttr с атрибутами SQL_ATTR_PARAM_BIND_TYPE или SQL_ATTR_ROW_BIND_TYPE после вызова SQLFetch или SQLFetchScroll , библиотека курсоров не выполняется. Прежде чем изменить тип привязки в библиотеке курсоров, приложение должно закрыть курсор. Библиотека курсоров поддерживает изменение атрибутов инструкции SQL_ATTR_ROW_BIND_OFFSET_PTR, SQL_ATTR_PARAM_BIND_OFFSET_PTR, SQL_ATTR_ROWS_FETCHED_PTR и SQL_ATTR_PARAMS_PROCESSED_PTR операторов при открытии курсора.

Приложение может вызывать SQLSetStmtAttr с атрибутом SQL_ATTR_ROW_ARRAY_SIZE, чтобы изменить размер набора строк при открытии курсора. Новый размер набора строк вступит в силу при следующем вызове SQLFetchScroll или SQLFetch .

Библиотека курсоров поддерживает настройку атрибута инструкции SQL_ATTR_PARAM_BIND_OFFSET_PTR или SQL_ATTR_ROW_BIND_OFFSET_PTR для включения смещения привязки. Смещение привязки не будет использоваться для вызовов SQLFetch при использовании библиотеки курсоров с ODBC 2.x driver.

Библиотека курсоров поддерживает настройку атрибута инструкции SQL_ATTR_USE_BOOKMARKS для SQL_UB_VARIABLE.