Número de linhas buscadas e status

Se o atributo de instrução SQL_ATTR_ROWS_FETCHED_PTR tiver sido definido, ele especificará um buffer que retornará o número de linhas buscadas pela chamada para SQLFetch ou SQLFetchScroll e linhas de erro. (Esse número é uma contagem de todas as linhas que não têm o status SQL_ROW_NO_ROWS.) Após uma chamada para SQLBulkOperations ou SQLSetPos, o buffer contém o número de linhas afetadas por uma operação em massa executada pela função. Se o atributo de instrução SQL_ATTR_ROW_STATUS_PTR tiver sido definido, SQLFetch ou SQLFetchScroll retornará a matriz de status da linha, que fornecerá o status de cada linha retornada. Ambos os buffers apontados por esses campos são alocados pelo aplicativo e preenchidos pelo driver. Um aplicativo deve garantir que o ponteiro permaneça válido até que o cursor seja fechado.

As entradas na matriz de status da linha indicam se o fetch de cada linha foi efetuado com êxito, se ela foi atualizada, adicionada ou excluída desde a última busca e se ocorreu um erro ao efetuar fetch. Se SQLFetch ou SQLFetchScroll encontrar um erro ao recuperar uma linha de um conjunto de linhas de várias linhas, ou se SQLBulkOperations com um argumento Operation de SQL_FETCH_BY_BOOKMARK encontrar um erro ao executar uma busca em massa, ele definirá o valor correspondente na matriz de status de linha como SQL_ROW_ERROR, continuará buscando linhas e retornará SQL_SUCCESS_WITH_INFO. Para obter mais informações sobre o tratamento de erros e a matriz de status de linha, confira as descrições das funções SQLFetch e SQLFetchScroll.