Matriz de status da linha

Além dos dados, SQLFetch e SQLFetchScroll podem retornar uma matriz que fornece o status de cada linha no conjunto de linhas. Essa matriz é especificada por meio do atributo de instrução SQL_ATTR_ROW_STATUS_PTR. Essa matriz é alocada pelo aplicativo e deve ter tantos elementos quanto especificados pelo atributo de instrução SQL_ATTR_ROW_ARRAY_SIZE. Os valores na matriz são definidos por SQLBulkOperations, SQLFetch, SQLFetchScroll e SQLSetPos. Os valores descrevem o status da linha e se esse status foi alterado desde a última busca.

Valor da matriz de status de linha	Description
SQL_ROW_SUCCESS	A linha foi buscada com sucesso e não foi modificada desde que foi buscada pela última vez.
SQL_ROW_SUCCESS_WITH_INFO	O registro foi recuperado com sucesso e não foi alterado desde a última vez que foi recuperado. No entanto, foi retornado um aviso sobre a linha.
SQL_ROW_ERROR	Ocorreu um erro ao tentar buscar a linha.
SQL_ROW_UPDATED	A linha foi buscada com êxito e tem sido atualizada desde a última vez que foi buscada. Se a linha for buscada novamente ou atualizada pelo SQLSetPos, seu status será alterado para o novo status. Alguns drivers não podem detectar alterações nos dados e, portanto, não podem retornar esse valor. Para determinar se um driver pode detectar atualizações para linhas refetchadas, um aplicativo chama SQLGetInfo com a opção SQL_ROW_UPDATES.
SQL_ROW_DELETED	A linha foi excluída desde a última consulta.
SQL_ROW_ADDED	A linha foi inserida por SQLBulkOperations. Se a linha for buscada novamente ou for atualizada pelo SQLSetPos, seu status será SQL_ROW_SUCCESS. Esse valor não é definido por SQLFetch ou SQLFetchScroll.
SQL_ROW_NOROW	O conjunto de linhas sobrepôs o final do conjunto de resultados e nenhuma linha foi retornada que correspondesse a esse elemento da matriz de status da linha.