Determinando o número de linhas afetadas

Depois de uma aplicação atualizar, eliminar ou inserir linhas, pode chamar o SQLRowCount para determinar quantas linhas foram afetadas. O SQLRowCount retorna este valor quer as linhas tenham sido atualizadas, eliminadas ou inseridas, quer não, pela execução de uma instrução UPDATE, DELETE ou INSERT, pela execução de uma instrução posicionada de atualização ou eliminação, ou pela chamada de SQLSetPos.

Se um lote de instruções SQL for executado, a contagem de linhas afetadas pode ser uma contagem total para todas as instruções do lote ou contagens individuais para cada instrução do lote. Para mais informações, consulte Lotes de Instruções SQL e Múltiplos Resultados.

O número de linhas afetadas também é devolvido no campo de cabeçalho SQL_DIAG_ROW_COUNT na secção de diagnóstico associada ao identificador da instrução. No entanto, os dados neste campo são redefinidos após cada chamada de função no mesmo handle de instrução, enquanto o valor devolvido por SQLRowCount permanece o mesmo até uma chamada para SQLBulkOperations, SQLExecute, SQLExecDirect, SQLPrepare ou SQLSetPos.