SQLRowCount

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure 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 Transact-SQL INSERT, UPDATE, DELETE, ou MERGE uma instrução com uma cláusula OUTPUT é executada, o SQLRowCount não retornará a contagem de linhas afetadas até que todas as linhas do conjunto de resultados geradas 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.