Ermitteln der Anzahl der betroffenen Zeilen

Nachdem eine Anwendung Zeilen aktualisiert, gelöscht oder eingefügt hat, kann sie SQLRowCount aufrufen, um zu bestimmen, wie viele Zeilen betroffen waren. SQLRowCount gibt diesen Wert zurück, unabhängig davon, ob die Zeilen durch Ausführen einer UPDATE, DELETE- oder INSERT-Anweisung, durch Ausführen einer positionierten UPDATE- oder DELETE-Anweisung oder durch Aufrufen von SQLSetPos aktualisiert, gelöscht oder eingefügt wurden.

Wenn ein Batch von SQL-Anweisungen ausgeführt wird, kann die Anzahl der betroffenen Zeilen eine Gesamtanzahl für alle Anweisungen im Batch oder für jede Anweisung im Batch sein. Weitere Informationen finden Sie unter Batchverarbeitung von SQL-Anweisungen und Mehrere Ergebnisse.

Die Anzahl der betroffenen Zeilen wird auch im Diagnosekopfzeilenfeld SQL_DIAG_ROW_COUNT des Diagnosebereichs zurückgegeben, der dem Anweisungshandle zugeordnet ist. Die Daten in diesem Feld werden jedoch nach jedem Funktionsaufruf im gleichen Anweisungshandle zurückgesetzt, während der von SQLRowCount zurückgegebene Wert bis zum Aufruf von SQLBulkOperations, SQLExecute, SQLExecDirect, SQLPrepare oder SQLSetPos gleich bleibt.