Hämtar bokmärken

Om programmet ska använda bokmärken måste det ange SQL_ATTR_USE_BOOKMARKS-instruktionsattributet till SQL_UB_VARIABLE innan instruktionen förbereds eller körs. Detta är nödvändigt eftersom det kan vara dyrt att skapa och underhålla bokmärken, så bokmärken bör endast aktiveras när ett program kan använda dem på ett bra sätt.

Bokmärken returneras som kolumn 0 i resultatuppsättningen. Det finns tre sätt som ett program kan hämta dem på:

• Bind kolumn 0 i resultatuppsättningen. SQLFetch eller SQLFetchScroll returnerar bokmärkena för varje rad i raduppsättningen tillsammans med data för andra bundna kolumner.

• Anropa SQLSetPos för att placera till en rad i raduppsättningen och anropa sedan SQLGetData för kolumn 0. Om en drivrutin stöder bokmärken måste den alltid ha stöd för möjligheten att anropa SQLGetData för kolumn 0, även om den inte tillåter att program anropar SQLGetData för andra kolumner före den sista bundna kolumnen.

• Anropa SQLBulkOperations med argumentet Operation inställt på SQL_ADD och kolumn 0 bunden. Markören infogar raden och returnerar bokmärket för raden i den bundna bufferten.