SQLRowCount

Quando matrizes de valores de parâmetro são associadas à execução da instrução, SQLRowCount retorna SQL_ERROR se qualquer linha de valores de parâmetro gera uma condição de erro na execução da instrução. Nenhum valor é retornado por meio do argumento RowCountPtr da função.

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

Além disso, o aplicativo pode usar uma matriz de valores de status, associada usando o atributo de instrução SQL_ATTR_PARAM_STATUS_PTR, para capturar os deslocamentos de matriz de linhas de parâmetros ofensivas. O aplicativo pode percorrer 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 sconsume essas linhas, você chama SQLFetch ou SQLFetchScroll. SQLResultCols retornará -1 até que todas as linhas de resultados sejam 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.

Consulte Também

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