SQLFetchScroll 从结果集中返回指定的行集。 行集可以按绝对位置或相对位置或书签指定。 只有在结果集存在时才能调用 SQLFetchScroll ，即在创建结果集的调用之后，以及关闭该结果集上的游标之前。 如果绑定了任何列，它将返回这些列中的数据。 如果应用程序已指定指向行状态数组的指针或要在其中返回提取的行数的缓冲区， SQLFetchScroll 也会返回此信息。 对 SQLFetchScroll 的调用可与对 SQLFetch 的调用 混合，但不能与对 SQLExtendedFetch 的 调用混合。

有关详细信息，请参阅 “使用块游标”和 “使用可滚动游标 ”。

创建结果集后，光标将定位在结果集的开头。 SQLFetchScroll 根据 FetchOrientation 和 FetchOffset 参数的值 定位块游标，如下表所示。 下一部分显示了用于确定新行集开始的确切规则。

驱动程序不需要支持所有提取方向;应用程序使用信息类型SQL_DYNAMIC_CURSOR_ATTRIBUTES1、SQL_KEYSET_CURSOR_ATTRIBUTES1或SQL_STATIC_CURSOR_ATTRIBUTES1（具体取决于游标的类型）调用 SQLGetInfo ，以确定驱动程序支持哪些提取方向。 应用程序应查看这些信息类型中的SQL_CA1_NEXT、SQL_CA1_RELATIVE、SQL_CA1_ABSOLUTE和WQL_CA1_BOOKMARK位掩码。 此外，如果游标仅向前且 FetchOrientation 不SQL_FETCH_NEXT， 则 SQLFetchScroll 将返回 SQLSTATE HY106（提取范围外的类型）。

SQL_ATTR_ROW_ARRAY_SIZE语句属性指定行集中的行数。 如果 SQLFetchScroll 提取的 行集与结果集的末尾重叠， SQLFetchScroll 将返回部分行集。 也就是说，如果 S + R - 1 大于 L，其中 S 是要提取的行集的起始行，则 R 是行集大小，L 是结果集中的最后一行，则只有第一行 L - S + 1 行行集有效。 其余行为空，状态为SQL_ROW_NOROW。

在 SQLFetchScroll 返回后 ，当前行是行集的第一行。

游标定位规则

以下部分介绍 FetchOrientation 的每个值的确切规则。 这些规则使用以下表示法。

[1] SQLFetchScroll 返回 SQLSTATE 01S06（尝试提取结果集前返回第一行集）并SQL_SUCCESS_WITH_INFO。

[2] 如果自上一次调用提取行以来已更改行集大小，则这是新的行集大小。

SQL_FETCH_RELATIVE

以下规则适用。

[1] SQLFetchScroll 返回与使用 FetchOrientation 设置为SQL_FETCH_ABSOLUTE调用的行集相同。 有关详细信息，请参阅“SQL_FETCH_ABSOLUTE”部分。

[2] SQLFetchScroll 返回 SQLSTATE 01S06（尝试提取结果集前返回第一行集）并SQL_SUCCESS_WITH_INFO。

[3] 如果自上一次调用提取行以来已更改行集大小，则这是新的行集大小。

SQL_FETCH_ABSOLUTE

以下规则适用。

[1] SQLFetchScroll 返回 SQLSTATE 01S06（尝试提取结果集前返回第一行集）并SQL_SUCCESS_WITH_INFO。

[2] 如果自上一次调用提取行以来已更改行集大小，则这是新的行集大小。

对动态游标执行的绝对提取无法提供所需的结果，因为动态游标中的行位置不确定。 此类操作等效于先提取后跟提取相对项;它不是原子操作，静态游标的绝对提取也是一种绝对提取。

SQL_FETCH_FIRST

以下规则适用。

有关书签的信息，请参阅 书签（ODBC）。

删除、添加和错误行对游标移动的影响

静态和键集驱动的游标有时会检测添加到结果集中的行，并删除从结果集中删除的行。 通过使用SQL_STATIC_CURSOR_ATTRIBUTES2和SQL_KEYSET_CURSOR_ATTRIBUTES2选项调用 SQLGetInfo 并查看SQL_CA2_SENSITIVITY_ADDITIONS、SQL_CA2_SENSITIVITY_DELETIONS和SQL_CA2_SENSITIVITY_UPDATES位掩码，应用程序将确定由特定驱动程序实现的游标是否执行此操作。 对于可以检测已删除行并删除它们的驱动程序，以下段落描述了此行为的影响。 对于可以检测已删除行但无法删除的驱动程序，删除不会影响游标移动，并且以下段落不适用。

如果游标检测到添加到结果集的行或删除从结果集中删除的行，则它似乎仅在提取数据时才检测到这些更改。 这包括在 将 FetchOrientation 设置为 SQL_FETCH_RELATIVE 的情况下调用 SQLFetchScroll ，并将 FetchOffset 设置为 0 以重新调用同一行集，但不包括使用 fOption 设置为SQL_REFRESH调用 SQLSetPos 的情况。 在后一种情况下，将刷新行集缓冲区中的数据，但不重新写入行，并且不会从结果集中删除已删除的行。 因此，当从当前行集中删除或插入行集时，游标不会修改行集缓冲区。 而是在提取以前包含已删除行或现在包含插入行的任何行集时检测更改。

// Fetch the next rowset.  
SQLFetchScroll(hstmt, SQL_FETCH_NEXT, 0);  
// Delete third row of the rowset. Does not modify the rowset buffers.  
SQLSetPos(hstmt, 3, SQL_DELETE, SQL_LOCK_NO_CHANGE);  
// The third row has a status of SQL_ROW_DELETED after this call.  
SQLSetPos(hstmt, 3, SQL_REFRESH, SQL_LOCK_NO_CHANGE);  
// Refetch the same rowset. The third row is removed, replaced by what  
// was previously the fourth row.  
SQLFetchScroll(hstmt, SQL_FETCH_RELATIVE, 0);  
当 SQLFetchScroll 返回相对于当前行集的位置的新行集（即 FetchOrientation SQL_FETCH_NEXT、SQL_FETCH_PRIOR或SQL_FETCH_RELATIVE）时，在计算新行集的起始位置时，它不包括对当前行集的更改。 但是，如果更改能够检测这些更改，则它确实包括当前行集之外的更改。 此外，当 SQLFetchScroll 返回一个新的行集，该行集的位置独立于当前行集（即 FetchOrientation 是SQL_FETCH_FIRST、SQL_FETCH_LAST、SQL_FETCH_ABSOLUTE或SQL_FETCH_BOOKMARK）时，它包括能够检测的所有更改，即使它们位于当前行集中也是如此。
确定新添加的行位于当前行集内还是外部时，将部分行集视为最后一个有效行结束;即行状态不SQL_ROW_NOROW的最后一行。 例如，假设游标能够检测新添加的行，当前行集是部分行集，应用程序会添加新行，游标会将这些行添加到结果集的末尾。 如果应用程序调用 将 FetchOrientation 设置为SQL_FETCH_NEXT的 SQLFetchScroll ， 则 SQLFetchScroll 将返回从第一个新添加的行开始的行集。
例如，假设当前行集包含行 21 到 30 行，行集大小为 10，游标从结果集中删除的行，游标检测添加到结果集中的行。 下表显示了 SQLFetchScroll 在各种情况下返回的行。
FetchOffset
新建行集[1]
[1] 此列在插入或删除任何行之前使用行号。
[2] 在这种情况下，游标尝试返回以第 21 行开头的行。 由于第 21 行已被删除，因此返回的第一行为第 22 行。
错误行（即状态为SQL_ROW_ERROR的行）不会影响游标移动。 例如，如果当前行集以第 11 行开头，并且第 11 行的状态为SQL_ROW_ERROR，则调用 将 FETCHOrientation 设置为 SQL_FETCH_RELATIVE 且 FetchOffset 设置为 5 的 SQLFetchScroll 将返回以第 16 行开头的行集，就像第 11 行的状态SQL_SUCCESS一样。
返回绑定列中的数据
SQLFetchScroll 以与 SQLFetch 相同的方式返回绑定列中的数据。 有关详细信息，请参阅 SQLFetch 函数中的“返回绑定列中的数据”。
如果未绑定任何列， SQLFetchScroll 不会返回数据，但会将块游标移动到指定位置。 是否可以使用 SQLGetData 从块游标的未绑定列中检索数据取决于驱动程序。 如果对 SQLGetInfo 的调用返回SQL_GETDATA_EXTENSIONS信息类型的SQL_GD_BLOCK位，则支持此功能。
缓冲区地址
SQLFetchScroll 使用相同的公式来确定数据地址和长度/指示器缓冲区作为 SQLFetch。 有关详细信息，请参阅 SQLBindCol 函数中的“缓冲区地址”。
行状态数组
SQLFetchScroll 以与 SQLFetch 相同的方式设置行状态数组中的值。 有关详细信息，请参阅 SQLFetch 函数中的“行状态数组”。
提取的行缓冲区
SQLFetchScroll 以与 SQLFetch 相同的方式返回提取的行中提取的行数。 有关详细信息，请参阅 SQLFetch 函数中的“行提取缓冲区”。
当应用程序在 ODBC 3.x 驱动程序中调用 SQLFetchScroll 时，驱动程序管理器会在驱动程序中调用 SQLFetchScroll 。 当应用程序在 ODBC 2.x 驱动程序中调用 SQLFetchScroll 时，驱动程序管理器会在驱动程序中调用 SQLExtendedFetch。 由于 SQLFetchScroll 和 SQLExtendedFetch 以略有不同的方式处理错误，因此当应用程序在 ODBC 2.x 和 ODBC 3.x 驱动程序中调用 SQLFetchScroll 时会看到略有不同的错误行为。
SQLFetchScroll 以与 SQLFetch 相同的方式返回错误和警告;有关详细信息，请参阅 SQLFetch 中的“错误处理”。 SQLExtendedFetch 以与 SQLFetch 相同的方式返回错误，但有以下例外：
当发生应用于行集中特定行的警告时，SQLExtendedFetch 会将行状态数组中的相应条目设置为SQL_ROW_SUCCESS，而不是SQL_ROW_SUCCESS_WITH_INFO。
如果行集中的每一行中出现错误，SQLExtendedFetch 将返回SQL_SUCCESS_WITH_INFO，而不是SQL_ERROR。
在每个应用于单个行的状态记录组中，SQLExtendedFetch 返回的第一条状态记录必须包含 SQLSTATE 01S01（行错误）： SQLFetchScroll 不返回此 SQLSTATE。 如果 SQLExtendedFetch 无法返回其他 SQLSTATE，它仍必须返回此 SQLSTATE。
SQLFetchScroll 和乐观并发
如果游标使用乐观并发（即，SQL_ATTR_CONCURRENCY语句属性的值为 SQL_CONCUR_VALUES 或 SQL_CONCUR_ROWVER - SQLFetchScroll 将更新数据源用来检测行是否已更改的乐观并发值。 每当 SQLFetchScroll 提取新的行集（包括重新提取当前行集时）就会发生这种情况。 （调用 FetchOrientation 设置为 SQL_FETCH_RELATIVE，FetchOffset 设置为 0。
SQLFetchScroll 和 ODBC 2.x 驱动程序
当应用程序在 ODBC 2.x 驱动程序中调用 SQLFetchScroll 时，驱动程序管理器会将此调用映射到 SQLExtendedFetch。 它为 SQLExtendedFetch 的参数传递以下值。
SQLExtendedFetch 参数
FetchOffset
如果未SQL_FETCH_BOOKMARK FetchOrientation，则使用 SQLFetchScroll 中的 FetchOffset 参数的值。

 如果 FetchOrientation SQL_FETCH_BOOKMARK，则使用存储在 SQL_ATTR_FETCH_BOOKMARK_PTR 语句属性指定的地址处的值。
RowCountPtr
SQL_ATTR_ROWS_FETCHED_PTR语句属性指定的地址。
RowStatusArray
SQL_ATTR_ROW_STATUS_PTR语句属性指定的地址。
有关详细信息，请参阅“附录 G：驱动程序后向兼容性指南”中的块游标、可滚动游标和后向兼容性。
描述符和 SQLFetchScroll
SQLFetchScroll 以与 SQLFetch 相同的方式与描述符交互。 有关详细信息，请参阅 SQLFetch 函数中的“描述符和 SQLFetchScroll”部分。
请参阅列明智绑定、行顺序绑定、定位的 Update 和 Delete 语句，以及使用 SQLSetPos 更新行集中的行。
有关以下内容的信息