SQLNumResultColsSQLNumResultCols

適用対象: yesSQL Server yesAzure SQL Database yesAzure Synapse Analytics (SQL DW) yesParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database yesAzure Synapse Analytics (SQL DW) yesParallel Data Warehouse

実行されたステートメントの場合、SQL ServerSQL Server Native 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. これらのより正確な結果は、以前のバージョンの SQL ServerSQL Serverで SQLNumResultCols によって返される値とは異なる場合があります。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