影響を受ける行数の決定

アプリケーションは、行を更新、削除、または挿入した後、SQLRowCount を呼び出して、影響を受けた行の数を確認できます。 SQLRowCount は、UPDATE、DELETE、または INSERT ステートメントを実行するか、配置された更新または削除ステートメントを実行するか、SQLSetPos を呼び出すことによって、行が更新、削除、挿入されたかどうかに関係なく、この値を返します。

SQL ステートメントのバッチが実行される場合、影響を受ける行の数は、バッチ内のすべてのステートメントの合計数、またはバッチ内の各ステートメントの個々の数になる可能性があります。 詳細については、「SQL ステートメントのバッチ」および「複数の結果」を参照してください。

影響を受ける行の数は、ステートメント ハンドルに関連付けられている診断領域の SQL_DIAG_ROW_COUNT 診断ヘッダー フィールドにも返されます。 ただし、このフィールドのデータは、同じステートメント ハンドルに対するすべての関数呼び出しの後にリセットされますが、SQLRowCount によって返される値は、SQLBulkOperations、SQLExecute、SQLExecDirect、SQLPrepare、または SQLSetPos の呼び出しまで同じままです。