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 um Transact-SQL instrução INSERT, UPDATE, DELETE ou MERGE com uma cláusula OUTPUT for executado, SQLRowCount não retornará a contagem de linhas afetadas até que todas as linhas no conjunto de resultados gerados pela cláusula OUTPUT sejam 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