SQLRowCount

van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Wanneer arrays van parameterwaarden worden gebonden aan de uitvoering van een statement, geeft SQLRowCount SQL_ERROR terug als een rij parameterwaarden een foutconditie genereert bij de uitvoering van een statement. Er wordt geen waarde teruggegeven via het RowCountPtr-argument van de functie.

De applicatie kan gebruikmaken van het SQL_ATTR_PARAMS_PROCESSED_PTR-statementattribuut om het aantal parameters vast te leggen dat vóór het optreden van de fout wordt verwerkt.

Verder kan de applicatie een array van statuswaarden gebruiken, begrensd door het SQL_ATTR_PARAM_STATUS_PTR-statementattribuut, om de array-offsets van de betreffende parameterrijen vast te leggen. De applicatie kan de statusarray doorlopen om het daadwerkelijke aantal verwerkte rijen te bepalen.

Wanneer een Transact-SQL INSERT, UPDATE, DELETE, of MERGE een instructie met een OUTPUT-clausule wordt uitgevoerd, zal SQLRowCount het aantal getroffen rijen pas teruggeven nadat alle rijen in de resultaatset die door de OUTPUT-clausule is gegenereerd, zijn verbruikt. Om deze rijen te gebruiken, roep je SQLFetch of SQLFetchScroll aan. SQLResultCols geeft -1 terug totdat alle resultaatrijen zijn verbruikt. Nadat SQLFetch of SQLFetchScroll SQL_NO_DATA heeft teruggebracht, moet de applicatie SQLRowCount aanroepen om het aantal getroffen rijen te bepalen voordat SQLMoreResults wordt aangeroepen om naar het volgende resultaat te gaan.

Zie ook

SQLRowCount-functie
Details van ODBC-API-implementatie