若應用程式將使用書籤,必須在準備或執行該陳述前,先將SQL_ATTR_USE_BOOKMARKS陳述句屬性設為SQL_UB_VARIABLE。 這是必要的,因為建立與維護書籤可能是一項昂貴的作業,因此只有當應用程式能有效利用書籤時,才應啟用書籤。
書籤會以結果集的第 0 列回傳。 應用程式有三種方式可以取得這些資料:
綁定結果集的第 0 欄。 SQLFetch 或 SQLFetchScroll 會回傳列集中每一列的書籤,以及其他綁定欄位的資料。
呼叫 SQLSetPos 定位到列集中的某一列,然後呼叫 SQLGetData 取得第 0 欄。 若驅動程式支援書籤,必須始終支援呼叫第 0 欄的 SQLGetData ,即使不允許應用程式在最後綁定欄位前呼叫其他欄位的 SQLGetData 。
呼叫 SQLBulkOperations ,將 Operation 參數設為 SQL_ADD,欄位為 0。 游標插入該列,並回傳綁定緩衝區中該列的書籤。