Freigeben über


Anzahl von abgerufenen Zeilen und Status

Wenn das attribut der SQL_ATTR_ROWS_FETCHED_PTR-Anweisung festgelegt wurde, gibt es einen Puffer an, der die Anzahl der Zeilen zurückgibt, die vom Aufruf von SQLFetch oder SQLFetchScroll abgerufen werden, und Fehlerzeilen. (Diese Zahl ist eine Anzahl aller Zeilen, die nicht über den Status SQL_ROW_NO_ROWS verfügen.) Nach einem Aufruf von SQLBulkOperations oder SQLSetPos enthält der Puffer die Anzahl der Zeilen, die von einem Massenvorgang betroffen waren, der von der Funktion ausgeführt wird. Wenn das attribut der SQL_ATTR_ROW_STATUS_PTR-Anweisung festgelegt wurde, gibt SQLFetch oder SQLFetchScroll das Zeilenstatusarray zurück, das den Status jeder zurückgegebenen Zeile bereitstellt. Beide Puffer, auf die von diesen Feldern verwiesen wird, werden von der Anwendung zugewiesen und vom Treiber aufgefüllt. Eine Anwendung muss sicherstellen, dass diese Zeiger erneut Standard gültig sind, bis der Cursor geschlossen ist.

Einträge im Zeilenstatusarrayzustand, ob jede Zeile erfolgreich abgerufen wurde, ob sie seit dem letzten Abruf aktualisiert, hinzugefügt oder gelöscht wurde und ob beim Abrufen der Zeile ein Fehler aufgetreten ist. Wenn SQLFetch oder SQLFetchScroll beim Abrufen einer Zeile eines Mehrrow-Rowsets oder sqlBulkOperations mit einem Argument "Operation" von SQL_FETCH_BY_BOOKMARK beim Ausführen eines Massenabrufs einen Fehler auftritt, legt sie den entsprechenden Wert im Zeilenstatusarray auf SQL_ROW_ERROR fest, ruft Zeilen weiter ab und gibt SQL_SUCCESS_WITH_INFO zurück. Weitere Informationen zur Fehlerbehandlung und zum Zeilenstatusarray finden Sie in den Beschreibungen der SQLFetch - und SQLFetchScroll-Funktion .