Etapa 4a: Buscar os resultados

A próxima etapa é buscar os resultados, conforme mostrado na ilustração a seguir.

Se a instrução executada na "Etapa 3: Criar e executar uma instrução SQL" for uma instrução SELECT ou uma função de catálogo, o aplicativo primeiro chamará SQLNumResultCols para determinar o número de colunas no conjunto de resultados. Essa etapa não será necessária se o aplicativo já souber o número de colunas do conjunto de resultados, como quando a instrução SQL é embutida em código permanentemente em um aplicativo vertical ou personalizado.

Em seguida, o aplicativo recupera o nome, o tipo de dados, a precisão e a escala de cada coluna do conjunto de resultados com SQLDescribeCol. Novamente, isso não é necessário para aplicativos como aplicativos verticais e personalizados que já conhecem essas informações. O aplicativo passa essas informações para SQLBindCol, que vincula uma variável de aplicativo a uma coluna no conjunto de resultados.

O aplicativo agora chama SQLFetch para recuperar a primeira linha de dados e colocar os dados dessa linha nas variáveis associadas a SQLBindCol. Se houver dados longos na linha, ele chamará SQLGetData para recuperar esses dados. O aplicativo continua a chamar SQLFetch e SQLGetData para recuperar dados adicionais. Após terminar de buscar os dados, ele chama SQLCloseCursor para fechar o cursor.

Para obter uma descrição completa da recuperação de resultados, consulte Recuperar resultados (básico) e Recuperar resultados (avançado).

O aplicativo agora retorna à "Etapa 3: Criar e executar uma instrução SQL" para executar outra instrução na mesma transação; ou prossegue para "Etapa 5: Confirmar a transação" para confirmar ou reverter a transação.