Passaggio 4a: Recuperare i risultati

Il passaggio successivo consiste nel recuperare i risultati, come illustrato nella figura seguente.

Se l'istruzione eseguita in "Passaggio 3: Compilare ed eseguire un'istruzione SQL" è un'istruzione SELECT o una funzione catalogo, l'applicazione chiama prima SQLNumResultCols per determinare il numero di colonne nel set di risultati. Questo passaggio non è necessario se l'applicazione conosce già il numero di colonne del set di risultati, ad esempio quando l'istruzione SQL è hardcoded in un'applicazione verticale o personalizzata.

Successivamente, l'applicazione recupera il nome, il tipo di dati, la precisione e la scala di ogni colonna del set di risultati con SQLDescribeCol. Anche in questo caso, l’operazione non è necessaria per applicazioni come le applicazioni verticali e personalizzate che conoscono già queste informazioni. L'applicazione passa queste informazioni a SQLBindCol, che associa una variabile dell'applicazione a una colonna nel set di risultati.

L'applicazione chiama ora SQLFetch per recuperare la prima riga di dati e inserire i dati da tale riga nelle variabili associate a SQLBindCol. Se nella riga sono presenti dati lunghi, chiama SQLGetData per recuperare tali dati. L'applicazione continua a chiamare SQLFetch e SQLGetData per recuperare dati aggiuntivi. Al termine del recupero dei dati, chiama SQLCloseCursor per chiudere il cursore.

Per una descrizione completa del recupero dei risultati, vedere Recupero dei risultati (base) e Recupero dei risultati (avanzato).

L'applicazione torna ora al “Passaggio 3: Compilare ed eseguire un'istruzione SQL" per eseguire un'altra istruzione nella stessa transazione, oppure procede al “Passaggio 5: eseguire il commit della transazione” per eseguire il commit o il rollback della transazione.