Etapa 4a: Buscar os resultados

O passo seguinte é buscar os resultados, como mostrado na ilustração seguinte.

Se a instrução executada em "Step 3: Build and Execute a SQL Statement" fosse uma instrução SELECT ou uma função de catálogo, a aplicação chama primeiro SQLNumResultCols para determinar o número de colunas no conjunto de resultados. Este passo não é necessário se a aplicação já souber o número de colunas do conjunto de resultados, como quando a instrução SQL está codificada diretamente numa aplicação vertical ou personalizada.

De seguida, a aplicação recupera o nome, tipo de dado, precisão e escala de cada coluna do conjunto de resultados com SQLDescribeCol. Mais uma vez, isto não é necessário para aplicações como aplicações verticais e personalizadas que já conhecem esta informação. A aplicação passa esta informação para o SQLBindCol, que associa uma variável de aplicação a uma coluna do conjunto de resultados.

A aplicação agora chama SQLFetch para recuperar a primeira linha de dados e colocar os dados dessa linha nas variáveis vinculadas com SQLBindCol. Se houver dados longos na linha, então chama SQLGetData para recuperar esses dados. A aplicação continua a chamar SQLFetch e SQLGetData para recuperar dados adicionais. Depois de terminar de obter dados, chama SQLCloseCursor para fechar o cursor.

Para uma descrição completa da recuperação de resultados, veja Recuperar Resultados (Básico) e Recuperar Resultados (Avançado).

A aplicação agora regressa ao "Passo 3: Construir e Executar uma Instrução SQL" para executar outra instrução na mesma transação; ou segue para o "Passo 5: Comprometer a Transação" para comprometer ou reverter a transação.