Abrufen von Textmarken

Wenn die Anwendung Textmarken verwendet, muss das attribut der SQL_ATTR_USE_BOOKMARKS-Anweisung auf SQL_UB_VARIABLE festgelegt werden, bevor die Anweisung vorbereitet oder ausgeführt wird. Dies ist notwendig, da das Erstellen und Standard Nachtragen von Lesezeichen ein teurer Vorgang sein kann, sodass Lesezeichen nur aktiviert werden sollten, wenn eine Anwendung sie gut nutzen kann.

Textmarken werden als Spalte 0 des Resultsets zurückgegeben. Es gibt drei Möglichkeiten, wie eine Anwendung sie abrufen kann:

• Binden Sie Spalte 0 des Resultsets. SQLFetch oder SQLFetchScroll gibt die Lesezeichen für jede Zeile im Rowset zusammen mit den Daten für andere gebundene Spalten zurück.

• Rufen Sie SQLSetPos auf, um eine Zeile im Rowset zu positionieren, und rufen Sie dann SQLGetData für Spalte 0 auf. Wenn ein Treiber Textmarken unterstützt, muss er immer die Möglichkeit unterstützen, SQLGetData für Spalte 0 aufzurufen, auch wenn anwendungen sqlGetData für andere Spalten vor der letzten gebundenen Spalte nicht aufrufen können.

• Rufen Sie SQLBulkOperations auf, wobei das Argument Operation auf SQL_ADD und spalte 0 gebunden ist. Der Cursor fügt die Zeile ein und gibt die Textmarke für die Zeile im gebundenen Puffer zurück.