Partilhar via


SQLRowCount

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure PDW (Sistema de Plataforma de Análise) do Azure Synapse Analytics

Quando matrizes de valores de parâmetro são associadas para execução de instrução, SQLRowCount retornará SQL_ERROR se qualquer linha de valores de parâmetro gerar uma condição de erro na execução da instrução. Nenhum valor é retornado pelo argumento RowCountPtr da função.

O aplicativo pode tirar proveito do atributo da instrução SQL_ATTR_PARAMS_PROCESSED_PTR para capturar o número de parâmetros processados antes de ocorrer o erro.

Além disso, o aplicativo pode usar uma matriz de valores de status, associada usando o atributo da instrução SQL_ATTR_PARAM_STATUS_PTR, para capturar os deslocamentos de matriz de linhas de parâmetro incorretas. O aplicativo pode atravessar a matriz de status para determinar o número real de linhas processadas.

Quando uma instrução Transact-SQL INSERT, UPDATE, DELETE ou MERGE com uma cláusula OUTPUT é executada, SQLRowCount não retornará a contagem de linhas afetadas até que todas as linhas no conjunto de resultados gerado pela cláusula OUTPUT tenham sido consumidas. Para consumir essas linhas, chame SQLFetch ou SQLFetchScroll. SQLResultCols retornará -1 até que todas as linhas de resultado tenham sido consumidas. Depois que SQLFetch ou SQLFetchScroll retornar SQL_NO_DATA, o aplicativo deverá chamar SQLRowCount para determinar o número de linhas afetadas antes de chamar SQLMoreResults para passar para o próximo resultado.

Confira também

Função SQLRowCount
Detalhes da implementação da API do ODBC