擷取書籤

  • 發行項

如果應用程式會使用書籤，必須先將 SQL_ATTR_USE_BOOKMARKS 陳述句屬性設定為 SQL_UB_VARIABLE，才能準備或執行陳述式。 這是必要的步驟，因為組建和維護書籤可能所費不貲，所以只有在應用程式能充分利用書籤時，才建議啟用書籤。

會在結果集的資料行 0 傳回書籤。 應用程式擷取書籤的方式有三種：

  • 繫結結果集的資料行 0。 SQLFetch 或 SQLFetchScroll 會傳回資料列集中每個資料列的書籤，以及其他繫結資料行的資料。

  • 呼叫 SQLSetPos 以定位至資料列集中的資料列，然後對資料行 0 呼叫 SQLGetData。 如果驅動程式支援使用書籤，即使不允許應用程式對最後一個繫結資料行前的其他資料行呼叫 SQLGetData，也一律必須支援對資料行 0 呼叫 SQLGetData 的功能。

  • 呼叫 SQLBulkOperations，其中 Operation 引數須設為 SQL_ADD，資料行 0 須進行繫結。 資料指標會插入資料列，並傳回繫結緩衝區中資料列的書籤。