SQLNumResultCols

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Bei ausgeführten Anweisungen besucht der SQL Server Native Client ODBC-Treiber den Server nicht, um die Anzahl der Spalten in einem Resultset zu melden. In diesem Fall verursacht SQLNumResultCols keinen Server roundtrip. Wie SQLDescribeCol und SQLColAttribute generiert das Aufrufen von SQLNumResultCols für vorbereitete, aber nicht ausgeführte Anweisungen einen Server-Roundtrip.

Wenn eine Transact-SQL-Anweisung oder ein Anweisungsbatch mehrere Ergebniszeilensätze zurückgibt, kann sich die Anzahl der Resultsetspalten von einem Satz zu einem anderen ändern. SQLNumResultCols sollte für jede Gruppe aufgerufen werden. Wenn sich die Anzahl der Spalten ändert, sollte die Anwendung Datenwerte vor dem Abrufen von Zeilenergebnissen erneut binden. Weitere Informationen zum Behandeln mehrerer Resultset-Rückgaben finden Sie unter SQLMoreResults.

Verbesserungen in der Datenbank-Engine ab SQL Server 2012 (11.x) ermöglichen ES SQLNumResultCols, genauere Beschreibungen der erwarteten Ergebnisse zu erhalten. Diese genaueren Ergebnisse können sich von den Werten unterscheiden, die von SQLNumResultCols in früheren Versionen von SQL Server zurückgegeben wurden. Weitere Informationen finden Sie unter Metadatenermittlung.

Weitere Informationen

SQLNumResultCols-Funktion
ODBC API Implementation Details