SQLRowCount

适用于:SQL ServerAzure SQL 数据库Azure SQL 托管实例Azure Synapse AnalyticsAnalytics Platform System (PDW)

当参数值的数组绑定到语句执行时,如果任何参数值行在语句执行中生成错误条件, SQLRowCount 将返回SQL_ERROR。 不通过函数的 RowCountPtr 参数返回任何值。

应用程序可以利用 SQL_ATTR_PARAMS_PROCESSED_PTR 语句属性捕获在错误发生之前已处理的参数个数。

此外,应用程序还可以使用由状态值构成的数组(通过使用 SQL_ATTR_PARAM_STATUS_PTR 语句属性进行绑定),来捕获生成错误的参数行的数组偏移量。 应用程序可以遍历状态数组以确定已处理的实际行数。

当执行带有OUTPUT子句的 Transact-SQLINSERT、、UPDATEDELETE或MERGE语句时,SQLRowCount不会返回受影响的行计数,直到OUTPUT子句生成的结果集中所有行都被消耗完毕。 若要使用这些行,请调用 SQLFetch 或 SQLFetchScroll。 SQLResultCols 将返回 -1,直到使用所有结果行。 在 SQLFetch 或 SQLFetchScroll 返回SQL_NO_DATA后,应用程序必须调用 SQLRowCount 来确定受影响的行数,然后再调用 SQLMoreResults 以移动到下一个结果。

另请参阅

SQLRowCount 函数
ODBC API 实现细节