SQLGetInfo (Biblioteca de cursores)
Importante
Esse recurso será removido em uma versão futura do Windows. Evite usar esse recurso em um novo trabalho de desenvolvimento e planeje modificar aplicativos que atualmente usam esse recurso. A Microsoft recomenda usar a funcionalidade de cursor do driver.
Este tópico discute o uso da função SQLGetInfo na biblioteca de cursores. Para obter informações gerais sobre SQLGetInfo, consulte Função SQLGetInfo.
A biblioteca de cursores retorna valores para os seguintes valores de InfoType (| representa um OR bit a bit); para todos os outros valores de InfoType, ele chama SQLGetInfo no driver.
| Infotipo | Valor retornado |
|---|---|
| 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 | quaisquer valores retornados pelo driver Observação: quando os dados são recuperados com SQLFetchScroll, o SQLGetData dá suporte à funcionalidade especificada com os bitmasks SQL_GD_ANY_COLUMN e 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_ SIMULTANEIDADE | 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] Usado somente quando a biblioteca de cursores é usada com um driver ODBC 2.x.
Importante
A biblioteca de cursores implementa o mesmo comportamento de cursor quando as transações são confirmadas ou revertidas como a fonte de dados. Ou seja, confirmar ou reverter uma transação, chamando SQLEndTran ou usando o atributo de conexão SQL_ATTR_AUTOCOMMIT, pode fazer com que a fonte de dados exclua os planos de acesso e feche os cursores para todas as instruções em uma conexão. Para obter mais informações, consulte os tipos de informações SQL_CURSOR_COMMIT_BEHAVIOR e SQL_CURSOR_ROLLBACK_BEHAVIOR no SQLGetInfo.