Recuperando favoritos

Se a aplicação usar favoritos, deve definir o atributo da instrução SQL_ATTR_USE_BOOKMARKS para SQL_UB_VARIABLE antes de preparar ou executar a instrução. Isto é necessário porque construir e manter marcadores pode ser uma operação dispendiosa, pelo que os marcadores só devem ser ativados quando uma aplicação os conseguir tirar bom partido.

Os marcadores são retornados como a coluna número 0 do conjunto de resultados. Existem três formas de uma aplicação os recuperar:

• Vincula a coluna 0 do conjunto de resultados. SQLFetch ou SQLFetchScroll devolve os marcadores de cada linha do conjunto de linhas juntamente com os dados das outras colunas associadas.

• Chame SQLSetPos para posicionar numa linha do conjunto de linhas e depois chame SQLGetData para a coluna 0. Se um driver suportar marcadores, deve sempre suportar a capacidade de chamar SQLGetData para a coluna 0, mesmo que não permita que aplicações chamem SQLGetData para outras colunas antes da última coluna ligada.

• Chame SQLBulkOperations com o argumento Operação definido para SQL_ADD e a coluna 0 vinculada. O cursor insere a linha e devolve o marcador da linha no buffer vinculado.