SQLRowCount

適用対象:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

パラメーター値の配列がステートメントの実行にバインドされている場合、パラメーター値の行でステートメントの実行でエラー条件が生成された場合、 SQLRowCount はSQL_ERRORを返します。 関数の RowCountPtr 引数を通じて値が返されません。

アプリケーションは、SQL_ATTR_PARAMS_PROCESSED_PTR ステートメント属性を使用して、エラーが発生するまでに処理されたパラメーター数をキャプチャできます。

また、SQL_ATTR_PARAM_STATUS_PTR ステートメント属性を使用してバインドされた状態値の配列を使用して、問題のあるパラメーター行の配列オフセットをキャプチャできます。 アプリケーションは、状態配列をすべて確認し、実際に処理された行数を判断できます。

OUTPUT 句を含む Transact-SQL INSERT、UPDATE、DELETE、または MERGE ステートメントを実行すると、OUTPUT 句によって生成された結果セット内のすべての行が使用されるまで、SQLRowCount は影響を受ける行の数を返しません。 これらの行を使用するには、SQLFetch または SQLFetchScroll を呼び出します。 SQLResultCols は、すべての結果行が使用されるまで -1 を返します。 SQLFetch または SQLFetchScroll がSQL_NO_DATAを返した後、アプリケーションは SQLRowCount を呼び出して、SQLMoreResults を呼び出して次の結果に移動する前に、影響を受ける行数を決定する必要があります。

参照

SQLRowCount 関数
ODBC API 実装の詳細