SQLRowCount

Gilt für: SQL Server Azure SQL-Datenbank Azure SQL verwaltete Instanz Azure Synapse Analytics Analytics Platform System (PDW)

Sind Arrays für Parameterwerte für Anweisungsausführungen gebunden, gibt SQLRowCount den Wert SQL_ERROR zurück, wenn eine Zeile mit Parameterwerten eine Fehlerbedingung bei der Anweisungsausführung generiert. Kein Wert wird durch das RowCountPtr -Argument der Funktion zurückgegeben.

Die Anwendung nutzt das SQL_ATTR_PARAMS_PROCESSED_PTR-Anweisungsattribut, um die Anzahl der vor Auftreten des Fehlers verarbeiteten Parameter zu erfassen.

Darüber hinaus kann die Anwendung ein Array von Statuswerten verwenden, die mithilfe des SQL_ATTR_PARAM_STATUS_PTR-Anweisungsattributs gebunden sind, um die Arrayoffsets der ungültigen Parameterzeilen zu erfassen. Die Anwendung kann das Statusarray durchsuchen, um die tatsächliche Anzahl verarbeiteter Zeilen zu bestimmen.

Wenn eine Transact-SQL INSERT-, UPDATE-, DELETE- oder MERGE-Anweisung mit einer OUTPUT-Klausel ausgeführt wird, gibt SQLRowCount die Anzahl der betroffenen Zeilen erst zurück, wenn alle Zeilen im Resultset, die von der OUTPUT-Klausel generiert wurden, verbraucht wurden. Um diese Zeilen zu nutzen, rufen Sie SQLFetch oder SQLFetchScroll auf. SQLResultCols gibt -1 zurück, bis alle Ergebniszeilen verbraucht wurden. Nachdem SQLFetch oder SQLFetchScroll SQL_NO_DATA zurückgegeben hat, muss die Anwendung SQLRowCount aufrufen, um die Anzahl der betroffenen Zeilen zu ermitteln, bevor SQLMoreResults aufgerufen wird, um zum nächsten Ergebnis zu wechseln.

Weitere Informationen

SQLRowCount-Funktion
ODBC-API-Implementierungsdetails