SQLNumResultCols

Van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics

Voor uitgevoerde statements bezoekt de SQL Server Native Client ODBC-driver de server niet om het aantal kolommen in een resultaatset te rapporteren. In dit geval veroorzaakt SQLNumResultCols geen server-roundtrip. Net als SQLDescribeCol en SQLColAttribute genereert het aanroepen van SQLNumResultCols op voorbereide maar niet uitgevoerde statements een server-roundtrip.

Wanneer een Transact-SQL-statement of statementbatch meerdere reeks resultatenrijen teruggeeft, is het mogelijk dat het aantal kolommen van de ene set naar de andere verandert. SQLNumResultCols moeten voor elke set worden aangeroepen. Wanneer het aantal kolommen verandert, moet de applicatie de gegevenswaarden opnieuw binden voordat de rijresultaten worden opgehaald. Voor meer informatie over het omgaan met meervoudige resultaatsset-retouren, zie SQLMoreResults.

Verbeteringen in de database-engine, te beginnen met SQL Server 2012 (11.x), stellen SQLNumResultCols in staat om nauwkeurigere beschrijvingen van de verwachte resultaten te verkrijgen. Deze nauwkeurigere resultaten kunnen verschillen van de waarden die door SQLNumResultCols in eerdere versies van SQL Server worden teruggegeven. Voor meer informatie, zie Metadata Discovery.