Is er een resultatenset gemaakt?

In de meeste gevallen weten toepassingsprogrammeurs of de instructies die hun toepassing uitvoert, een resultatenset maken. Dit is het geval als de toepassing gebruikmaakt van in code vastgelegde SQL-instructies die zijn geschreven door de programmeur. Het is meestal het geval wanneer de toepassing SQL-instructies tijdens runtime maakt: de programmeur kan eenvoudig code opnemen die markeert of een SELECT-instructie of een INSERT-instructie wordt gemaakt. In enkele situaties kan de programmeur niet weten of een instructie een resultatenset maakt. Dit geldt als de toepassing een manier biedt voor de gebruiker om een SQL-instructie in te voeren en uit te voeren. Het is ook waar wanneer de toepassing tijdens runtime een instructie bouwt om een procedure uit te voeren.

In dergelijke gevallen roept de toepassing SQLNumResultCols aan om het aantal kolommen in de resultatenset te bepalen. Als dit 0 is, heeft de instructie geen resultatenset gemaakt; als dit een ander getal is, heeft de instructie een resultatenset gemaakt.

De toepassing kan SQLNumResultCols op elk gewenst moment aanroepen nadat de instructie is voorbereid of uitgevoerd. Omdat sommige gegevensbronnen echter niet eenvoudig de resultatensets kunnen beschrijven die worden gemaakt door voorbereide instructies, zullen de prestaties lijden als SQLNumResultCols wordt aangeroepen nadat een instructie is voorbereid, maar voordat deze wordt uitgevoerd.

Sommige gegevensbronnen ondersteunen ook het bepalen van het aantal rijen dat een SQL-instructie retourneert in een resultatenset. Hiervoor roept de toepassing SQLRowCount aan. Wat precies wordt bedoeld met het aantal rijen, hangt af van de instelling van de optie SQL_DYNAMIC_CURSOR_ATTRIBUTES2, SQL_FORWARD_ONLY_CURSOR_ATTRIBUTES2, SQL_KEYSET_CURSOR_ATTRIBUTES2 of SQL_STATIC_CURSOR_ATTRIBUTES2 (afhankelijk van het type cursor) zoals geretourneerd door een oproep van SQLGetInfo. Deze bitmasker geeft aan voor elk cursortype of het geretourneerde aantal rijen exact, geschat of helemaal niet beschikbaar is. Of het aantal rijen voor statische of sleutelsetgestuurde cursors wordt beïnvloed door wijzigingen die zijn aangebracht via SQLBulkOperations of SQLSetPos, of door geplaatste update- of verwijderinstructies, is afhankelijk van andere bits die worden geretourneerd door dezelfde optieargumenten die eerder zijn vermeld. Zie de beschrijving van de functie SQLGetInfo voor meer informatie.