擷取書籤

如果應用程式將使用書簽,則在準備或執行語句之前,它必須將 SQL_ATTR_USE_BOOKMARKS 語句屬性設定為 SQL_UB_VARIABLE。 這是必要的,因為建立和維護書簽可能是昂貴的作業,因此只有當應用程式可以充分利用書簽時,才應該啟用。

書簽會以資料行0的形式傳回結果集。 有三種方式可供應用程式取出:

  • 系結結果集的資料行0。 SQLFetchSQLFetchScroll 會傳回資料列集中每個資料列的書簽,以及其他系結資料行的資料。

  • 呼叫 SQLSetPos 以定位至資料列集中的資料列,然後呼叫資料行0的 SQLGetData 。 如果驅動程式支援書簽,它一定會支援對資料行0呼叫 SQLGetData 的能力,即使它不允許應用程式在最後一個系結資料行之前呼叫其他資料行的 SQLGetData 也是一樣。

  • 呼叫 SQLBulkOperations ,並將 Operation 引數設定為 SQL_ADD,並將資料行0系結。 資料指標會插入資料列,並傳回系結緩衝區中資料列的書簽。