滚动和提取行 - 在 ODBC 中为行加书签
适用于：
SQL Server Azure SQL 数据库 Azure SQL 托管实例 Azure Synapse Analytics Analytics Platform System (PDW)
书签是用于标识数据行的值。 只有驱动程序或数据源才知道书签值的含义。 例如，书签可能与行号一样简单，也可能与磁盘地址一样复杂。 在 ODBC 中，应用程序为特定行请求书签，存储该书签，并将其传回到游标以返回到该行。
使用 SQLFetchScroll 提取行时，应用程序可以使用书签作为选择起始行的基础。 这是一种绝对寻址的格式，因为它不依赖于当前游标位置。 若要滚动到书签行，应用程序可使用 FetchOrientation SQL_FETCH_BOOKMARK 调用 SQLFetchScroll。 此操作使用 SQL_ATTR_FETCH_BOOKMARK_PTR 选项属性所指向的书签。 它将返回以该书签标识的行开始的行集。 应用程序可以在 SQLFetchScroll 调用的 FetchOffset 参数中指定此操作的偏移量。 指定偏移量后，会通过将 FetchOffset 参数中的数字与由书签标识的这一行的编号相加来确定所返回行集的第一行。 SQL Server Native Client ODBC 驱动程序仅支持静态游标和键集游标上的书签。 如果在设置书签时要求动态游标，则转而打开键集游标。
书签还可以与 SQLBulkOperations 函数一起使用，对从书签开始的一组行执行操作。