SQLRowCount

Применимо к:SQL ServerAzure SQL DatabaseAzure Managed InstanceAzure Synapse Analytics AnalyticsPlatform 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