SQLNumResultColsSQLNumResultCols

適用対象: ○SQL Server ○Azure SQL Database ○Azure SQL Data Warehouse ○Parallel Data WarehouseAPPLIES TO: yesSQL Server yesAzure SQL Database yesAzure SQL Data Warehouse yesParallel Data Warehouse

実行されるステートメントをSQL ServerSQL ServerNative Client ODBC ドライバーは結果セット内の列の数を報告するサーバーを利用しません。For executed statements, the SQL ServerSQL Server Native Client ODBC driver does not visit the server to report the number of columns in a result set. この場合、 SQLNumResultColsサーバーとのやり取りは行われません。In this case, SQLNumResultCols does not cause a server roundtrip. ようなSQLDescribeColSQLColAttributeを呼び出すと、 SQLNumResultCols準備されていても実行されていないステートメントには、サーバーとのやり取りが生成されます。Like SQLDescribeCol and SQLColAttribute, calling SQLNumResultCols on prepared but not executed statements generates a server roundtrip.

Transact-SQLTransact-SQL ステートメントまたはステートメント バッチが複数の結果行セットを返すときは、結果セットの列数を報告する場合、あるセットから別のセットへ結果セットを変更することができます。When a Transact-SQLTransact-SQL 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セットごとに呼び出す必要があります。SQLNumResultCols should be called for each set. 列数が変化すると、アプリケーションでは行の結果をフェッチする前に、データ値を再バインドする必要があります。When the number of columns changes, the application should rebind data values prior to fetching row results. セットを返す複数の結果の処理の詳細についてを参照してくださいSQLMoreResultsします。For more information about handling multiple result set returns, see SQLMoreResults.

以降では、データベース エンジンの機能強化SQL Server 2012 (11.x)SQL Server 2012 (11.x)期待どおりの結果のより正確な記述を取得する SQLNumResultCols を許可します。Improvements in the database engine starting with SQL Server 2012 (11.x)SQL Server 2012 (11.x) allow SQLNumResultCols to obtain more accurate descriptions of the expected results. これらのより正確な結果の以前のバージョンの SQLNumResultCols によって返される値が異なる場合がありますSQL ServerSQL Serverします。These more accurate results may differ from the values returned by SQLNumResultCols in previous versions of SQL ServerSQL Server. 詳細については、次を参照してください。メタデータ検出します。For more information, see Metadata Discovery.

参照See Also

SQLNumResultCols 関数 SQLNumResultCols Function
ODBC API 実装の詳細ODBC API Implementation Details