SQLFetchScroll
功能描述
从结果集中提取指定的数据行集，并返回所有绑定列的数据。 可在绝对或相对位置或按书签指定行集。
接口原型
RETCODE SQL_API
SQLFetchScroll(HSTMT StatementHandle,
SQLSMALLINT FetchOrientation,
SQLLEN FetchOffset)
参数说明
| 参数名 | 参数说明 |
|---|---|
| StatementHandle | 语句句柄。 |
| FetchOrientation | 提取类型。详情见其他。
|
| FetchOffset | 要提取的行数。 此参数的解释取决于 FetchOrientation 参数的值。详情见其他。 |
返回
- SQL_SUCCESS：表示调用正确。
- SQL_ERROR：表示比较严重的错误，如：内存分配失败、建立连接失败等。
- SQL_INVALID_HANDLE：表示调用无效句柄。其他API的返回值同理。
其他
创建结果集时，游标将定位在结果集的开始位置。 SQLFetchScroll 根据 FetchOrientation 和 FetchOffset 参数的值定位块游标，如下表所示。 下一部分显示了用于确定新行集开始的确切规则。
| FetchOrientation | 含义 |
|---|---|
| SQL_FETCH_NEXT | 返回下一行集。 这等效于调用 SQLFetch。 SQLFetchScroll 忽略 FetchOffset 的值。 |
| SQL_FETCH_PRIOR | 返回以前的行集。 SQLFetchScroll 忽略 FetchOffset 的值。 |
| SQL_FETCH_RELATIVE | 从当前行 集的开始 返回行集 FetchOffset。 |
| SQL_FETCH_ABSOLUTE | 返回从 FetchOffset 行开始行集。 |
| SQL_FETCH_FIRST | 返回结果集的第一个行集。 SQLFetchScroll 忽略 FetchOffset 的值。 |
| SQL_FETCH_LAST | 返回结果集的最后一个完整的行集。 SQLFetchScroll 忽略 FetchOffset 的值。 |
| SQL_FETCH_BOOKMARK | 从由 SQL_ATTR_FETCH_BOOKMARK_PTR 语句属性指定的书签返回行集 FetchOffset 行。 |
