Stap 4a: de resultaten ophalen

De volgende stap bestaat uit het ophalen van de resultaten, zoals wordt weergegeven in de volgende afbeelding.

Als de instructie die in stap 3: Een SQL-instructie bouwen en uitvoeren werd uitgevoerd, een SELECT-instructie of een catalogusfunctie was, roept de toepassing eerst SQLNumResultCols aan om het aantal kolommen in de resultatenset te bepalen. Deze stap is niet nodig als de toepassing al het aantal kolommen van de resultatenset kent, zoals wanneer de SQL-instructie in een verticale of aangepaste toepassing is vastgelegd.

Vervolgens haalt de toepassing de naam, het gegevenstype, de precisie en de schaal van elke kolom van de resultatenset op met SQLDescribeCol. Dit is ook niet nodig voor toepassingen zoals verticale en aangepaste toepassingen die deze informatie al kennen. De toepassing geeft deze informatie door aan SQLBindCol, waarmee een toepassingsvariabele wordt gekoppeld aan een kolom in de resultatenset.

De toepassing roept nu SQLFetch aan om de eerste rij met gegevens op te halen en de gegevens uit die rij in de variabelen te plaatsen die zijn gebonden aan SQLBindCol. Als er lange gegevens in de rij staan, roept deze SQLGetData aan om die gegevens op te halen. De toepassing blijft SQLFetch en SQLGetData aanroepen om extra gegevens op te halen. Nadat de gegevens zijn opgehaald, wordt SQLCloseCursor aanroepen om de cursor te sluiten.

Zie Resultaten ophalen (Basis) en Resultaten ophalen (Geavanceerd) voor een volledige beschrijving van het ophalen van resultaten.

De toepassing keert nu terug naar stap 3: een SQL-instructie bouwen en uitvoeren om een andere instructie in dezelfde transactie uit te voeren; of gaat verder met stap 5: de transactie doorvoeren om de transactie vast te leggen of terug te draaien.