Recupero di segnalibri

Se l'applicazione userà segnalibri, deve impostare l'attributo dell'istruzione SQL_ATTR_USE_BOOKMARKS su SQL_UB_VARIABLE prima di preparare o eseguire l'istruzione. Ciò è necessario perché la compilazione e la gestione dei segnalibri può essere un'operazione costosa, quindi i segnalibri devono essere abilitati solo quando un'applicazione può usarli correttamente.

I segnalibri vengono restituiti come colonna 0 del set di risultati. Esistono tre modi in cui un'applicazione può recuperarli:

• Associare la colonna 0 del set di risultati. SQLFetch o SQLFetchScroll restituisce i segnalibri per ogni riga del set di righe insieme ai dati per altre colonne associate.

• Chiamare SQLSetPos per posizionare una riga nel set di righe e quindi chiamare SQLGetData per la colonna 0. Se un driver supporta i segnalibri, deve sempre supportare la possibilità di chiamare SQLGetData per la colonna 0, anche se non consente alle applicazioni di chiamare SQLGetData per altre colonne prima dell'ultima colonna associata.

• Chiamare SQLBulkOperations con l'argomento Operation impostato su SQL_ADD e la colonna 0 associata. Il cursore inserisce la riga e restituisce il segnalibro per la riga nel buffer associato.