SQLRowCount

Применимо: SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure azure Synapse Analytics Analytics Platform System (PDW)

Если для выполнения инструкции привязаны массивы значений параметров, то функция SQLRowCount возвращает значение SQL_ERROR, если любое из значений параметров создаст ошибочное условие при выполнении инструкции. Через аргумент RowCountPtr функции значение возвращено не будет.

Приложение может воспользоваться атрибутом инструкции SQL_ATTR_PARAMS_PROCESSED_PTR для получения количества параметров, обработанных до возникновения ошибки.

Кроме этого, приложение может использовать массив значений состояния, привязанный с помощью атрибута инструкции SQL_ATTR_PARAM_STATUS_PTR, для получения массива смещений вызвавших ошибку строк параметров. Чтобы выяснить действительное число обработанных строк, приложение может просмотреть этот массив.

Когда выполняется инструкция Transact-SQL INSERT, UPDATE, DELETE или MERGE с предложением OUTPUT, SQLRowCount не возвращает количество строк, затронутых до тех пор, пока не будут использованы все строки в результирующем наборе, созданном предложением OUTPUT. Чтобы использовать эти строки, вызовите SQLFetch или SQLFetchScroll. SQLResultCols возвращает значение -1 до тех пор, пока не будут использованы все строки результатов. После того как SQLFetch или SQLFetchScroll возвращает SQL_NO_DATA, приложение должно вызвать SQLRowCount, чтобы определить количество строк, затронутых перед вызовом SQLMoreResults, чтобы перейти к следующему результату.

См. также

Функция SQLRowCount
Подробные сведения о реализации API-интерфейсов ODBC