Beolvasott sorok és állapot száma

Ha a SQL_ATTR_ROWS_FETCHED_PTR utasítás attribútum be van állítva, egy puffert ad vissza, amely az SQLFetch vagy az SQLFetchScroll hívása által lekért sorok számát és a hibasorokat adja vissza. (Ez a szám az összes olyan sor számát adja meg, amely nem rendelkezik SQL_ROW_NO_ROWS állapotmal.) Az SQLBulkOperations vagy az SQLSetPos hívása után a puffer tartalmazza a függvény által végrehajtott tömeges művelet által érintett sorok számát. Ha a SQL_ATTR_ROW_STATUS_PTR utasítás attribútum be van állítva, az SQLFetch vagy az SQLFetchScroll visszaadja a sorállapot-tömböt, amely az egyes visszaadott sorok állapotát adja vissza. Az ezen mezők által mutatott puffereket az alkalmazás lefoglalja, és az illesztőprogram tölti ki. Az alkalmazásnak meg kell győződnie arról, hogy ezek a mutatók mindaddig érvényesek maradnak, amíg a kurzor be nem záródik.

A sorállapot-tömb bejegyzései azt jelzik, hogy az egyes sorok beolvasása sikeres volt-e, frissítve, hozzáadva vagy törölve lett-e a legutóbbi beolvasás óta, valamint hogy hiba történt-e a sor beolvasása során. Ha az SQLFetch vagy az SQLFetchScroll hibát tapasztal egy többhelyes sorkészlet egy sora beolvasása közben, vagy ha az SQLBulkOperations és a SQL_FETCH_BY_BOOKMARK műveleti argumentuma hibát tapasztal a tömeges beolvasás végrehajtása során, a sorállapot-tömb megfelelő értékét SQL_ROW_ERROR értékre állítja, folytatja a sorok beolvasását, és visszaadja a SQL_SUCCESS_WITH_INFO. A hibakezelésről és a sorállapot-tömbről további információt az SQLFetch és az SQLFetchScroll függvény leírásában talál.