Determinar o número de linhas afetadas

Depois que um aplicativo atualiza, exclui ou insere linhas, ele pode chamar SQLRowCount para determinar quantas linhas foram afetadas. O SQLRowCount retorna esse valor independentemente de as linhas terem sido atualizadas, excluídas ou inseridas executando uma instrução UPDATE, DELETE ou INSERT, executando uma atualização posicionada ou instrução de exclusão, ou chamando SQLSetPos.

Se um lote de instruções SQL for executado, a contagem de linhas afetadas poderá ser uma contagem total para todas as instruções no lote ou contagens individuais para cada instrução no lote. Para obter mais informações, consulte Lotes de instruções SQL e Vários resultados.

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