Skip to content

Latest commit

 

History

History
26 lines (21 loc) · 2.14 KB

File metadata and controls

26 lines (21 loc) · 2.14 KB
title description author ms.author ms.date ms.service ms.subservice ms.topic helpviewer_keywords apitype
SQLNumResultCols
SQLNumResultCols
markingmyname
maghan
03/14/2017
sql
native-client
reference
SQLNumResultCols function
DLLExport

SQLNumResultCols

[!INCLUDESQL Server Azure SQL Database Synapse Analytics PDW]

For executed statements, the [!INCLUDEssNoVersion] Native Client ODBC driver does not visit the server to report the number of columns in a result set. In this case, SQLNumResultCols does not cause a server roundtrip. Like SQLDescribeCol and SQLColAttribute, calling SQLNumResultCols on prepared but not executed statements generates a server roundtrip.

When a [!INCLUDEtsql] statement or statement batch returns multiple result row sets, it is possible for the number of result set columns to change from one set to another. SQLNumResultCols should be called for each set. When the number of columns changes, the application should rebind data values prior to fetching row results. For more information about handling multiple result set returns, see SQLMoreResults.

Improvements in the database engine starting with [!INCLUDEssSQL11] allow SQLNumResultCols to obtain more accurate descriptions of the expected results. These more accurate results may differ from the values returned by SQLNumResultCols in previous versions of [!INCLUDEssNoVersion]. For more information, see Metadata Discovery.

See Also

SQLNumResultCols Function
ODBC API Implementation Details