SQLGetInfo (библиотека курсоров)
Внимание
Эта функция будет удалена в будущей версии Windows. Избегайте использования этой функции в новых рабочих областях разработки и планируете изменять приложения, которые в настоящее время используют эту функцию. Корпорация Майкрософт рекомендует использовать функции курсора драйвера.
В этом разделе рассматривается использование функции SQLGetInfo в библиотеке курсоров. Общие сведения о SQLGetInfo см. в разделе "Функция SQLGetInfo".
Библиотека курсоров возвращает значения для следующих значений InfoType (| представляет побитовое ИЛИ); для всех остальных значений InfoType он вызывает SQLGetInfo в драйвере.
| InfoType | Возвращаемое значение |
|---|---|
| SQL_BOOKMARK_PERSISTENCE | SQL_BP_SCROLL |
| SQL_DYNAMIC_CURSOR_ATTRIBUTES1 | 0 |
| SQL_DYNAMIC_CURSOR_ATTRIBUTES2 | 0 |
| SQL_FETCH_DIRECTION[1] | SQL_FD_FETCH_ABSOLUTE | SQL_FD_FETCH_FIRST | SQL_FD_FETCH_LAST | SQL_FD_FETCH_NEXT | SQL_FD_FETCH_PRIOR | SQL_FD_FETCH_RELATIVE | SQL_FD_FETCH_BOOKMARK |
| SQL_FORWARD_ONLY_CURSOR_ATTRIBUTES1 | SQL_CA1_NEXT | SQL_CA1_ABSOLUTE | SQL_CA1_RELATIVE | SQL_CA1_LOCK_NO_CHANGE | SQL_CA1_POS_POSITION | SQL_CA1_POSITIONED_DELETE | SQL_CA1_POSITIONED_UPDATE | SQL_CA1_SELECT_FOR_UPDATE |
| SQL_FORWARD_ONLY_CURSOR_ATTRIBUTES2 | SQL_CA2_READ_ONLY_CONCUR | SQL_CA2_OPT_VALUES_CONCURRENCY | SQL_CA2_SENSITIVITY_UPDATES |
| SQL_GETDATA_EXTENSIONS | SQL_GD_BLOCK | любые значения, возвращаемые драйвером Примечание. Когда данные извлекаются с помощью SQLFetchScroll, SQLGetData поддерживает функциональные возможности, указанные с помощью SQL_GD_ANY_COLUMN и SQL_GD_BOUND битов. |
| SQL_KEYSET_DRIVEN_CURSOR_ATTRIBUTES1 | 0 |
| SQL_KEYSET_DRIVEN_CURSOR_ATTRIBUTES2 | 0 |
| SQL_LOCK_TYPES[1] | SQL_LCK_NO_CHANGE |
| SQL_STATIC_CURSOR_ATTRIBUTES1 | SQL_CA1_NEXT | SQL_CA1_ABSOLUTE | SQL_CA1_RELATIVE | SQL_CA1_BOOKMARK | SQL_CA1_LOCK_NO_CHANGE | SQL_CA1_POS_POSITION | SQL_CA1_POSITIONED_DELETE | SQL_CA1_POSITIONED_UPDATE | SQL_CA1_SELECT_FOR_UPDATE |
| SQL_STATIC_CURSOR_ATTRIBUTES2 | SQL_CA2_READ_ONLY_CONCUR | SQL_CA2_OPT_VALUES_ ПАРАЛЛЕЛИЗМ | SQL_CA2_SENSITIVITY_UPDATES |
| SQL_POS_OPERATIONS[1] | SQL_POS_POSITION |
| SQL_POSITIONED_STATEMENTS[1] | SQL_PS_POSITIONED_DELETE | SQL_PS_POSITIONED_UPDATE | SQL_PS_SELECT_FOR_UPDATE |
| SQL_ROW_UPDATES | «Y» |
| SQL_SCROLL_CONCURRENCY[1] | SQL_SCCO_READ_ONLY | SQL_SCCO_OPT_VALUES |
| SQL_SCROLL_OPTIONS | SQL_SO_FORWARD_ONLY | SQL_SO_STATIC |
| SQL_STATIC_SENSITIVITY[1] | SQL_SS_UPDATES |
[1] Используется только в том случае, если библиотека курсоров используется с драйвером ODBC 2.x.
Внимание
Библиотека курсоров реализует то же поведение курсора, когда транзакции фиксируются или откатываются в качестве источника данных. То есть фиксация или откат транзакции путем вызова SQLEndTran или с помощью атрибута подключения SQL_ATTR_AUTOCOMMIT может привести к удалению планов доступа и закрытию курсоров для всех инструкций подключения. Дополнительные сведения см. в SQL_CURSOR_COMMIT_BEHAVIOR и SQL_CURSOR_ROLLBACK_BEHAVIOR типах сведений в SQLGetInfo.