Recuperar indicadores

Se o aplicativo usar marcadores, ele deverá definir o atributo de instrução SQL_ATTR_USE_BOOKMARKS como SQL_UB_VARIABLE antes de preparar ou executar a instrução. Isso é necessário porque criar e manter marcadores pode ser uma operação dispendiosa, portanto, os marcadores devem ser habilitados apenas quando um aplicativo pode fazer bom uso deles.

Os marcadores são retornados como a coluna 0 do conjunto de resultados. Há três maneiras de um aplicativo pode recuperá-los:

• Associar a coluna 0 do conjunto de resultados. SQLFetch ou SQLFetchScroll retorna os marcadores para cada linha no conjunto de linhas junto com os dados de outras colunas associadas.

• Chame SQLSetPos para posicionar em uma linha no conjunto de linhas e então chame SQLGetData para a coluna 0. Se um driver der suporte a marcadores, ele sempre deverá dar suporte à capacidade de chamar SQLGetData para a coluna 0, mesmo que não permita que os aplicativos chamem SQLGetData para outras colunas antes da última coluna acoplada.

• Chama SQLBulkOperations com o argumento Operation definido como SQL_ADD e coluna 0 associada. O cursor insere a linha e retorna o indicador da linha no buffer associado.