Important
此功能将在将来的 Windows 版本中删除。 避免在新开发工作中使用此功能,并计划修改当前使用此功能的应用程序。 Microsoft建议使用驱动程序的游标功能。
要使用 ODBC 光标库,有一个应用程序:
调用带有属性 为 SQL_ATTR_ODBC_CURSORS 的 SQLSetConnectAttr 来指定光标库在特定连接中的使用方式。 光标库可以始终使用(SQL_CUR_USE_ODBC)、仅在驱动不支持可滚动光标时使用(SQL_CUR_USE_IF_NEEDED),或从未使用(SQL_CUR_USE_DRIVER)。
调用 SQLConnect、 SQLDriverConnect 或 SQLBrowseConnect 连接数据源。
调用 SQLSetStmtAttr 指定光标类型(SQL_ATTR_CURSOR_TYPE)、并发性(SQL_ATTR_CONCURRENCY)和行集大小(SQL_ATTR_ROW_ARRAY_SIZE)。 光标库支持仅前进和静态光标。 仅前向光标必须是只读的,而静态光标可以是只读的,也可以使用乐观并发控制来比较值。
分配一个或多个行集缓冲区,并多次调用 SQLBindCol 将这些缓冲区绑定到结果集列。
通过执行 SELECT 语句或过程,或调用目录函数生成结果集。 如果应用程序执行定位更新语句,应执行 SELECT FOR UPDATE 语句以生成结果集。
调用 SQLFetch 或 SQLFetchScroll 一次或多次,滚动查看结果集。
应用程序可以更改行集缓冲区中的数据值。 为了用光标库缓存中的数据刷新行集缓冲区,应用程序调用 SQLFetchScroll,将 FetchOrientation 参数设为 SQL_FETCH_RELATIVE,FetchOffset 参数设为 0。
为了从未绑定的列中获取数据,应用程序调用 SQLSetPos 将光标放置在目标行上。 然后它调用 SQLGetData 来获取数据。
为了确定从数据源检索到的行数,应用程序调用 SQLRowCount。