检索书签

如果应用程序将使用书签,则必须先将 SSQL_ATTR_USE_BOOKMARKS 语句属性设置为 SQL_UB_VARIABLE,然后才能准备或执行该语句。 这是必要的,因为生成和维护书签可能是一项昂贵的操作,因此只有当应用程序可以很好地利用书签时,才应该启用它们。

书签作为结果集的第 0 列返回。 应用程序可以通过三种方式检索它们:

  • 绑定结果集的第 0 列。 SQLFetchSQLFetchScroll 返回行集中每一行的书签,以及其他绑定列的数据。

  • 调用 SQLSetPos 以定位到行集中的某一行,然后为第 0 列调用 SQLGetData。 如果驱动程序支持书签,则它必须始终支持为第 0 列调用 SQLGetData 的功能,即使它不允许应用程序在最后一个绑定列之前为其他列调用 SQLGetData

  • 在将 Operation 参数设置为 SQL_ADD 并绑定第 0 列的情况下调用 SQLBulkOperations。 游标插入行并返回绑定缓冲区中的行的书签。