int mysql_next_result(MYSQL *mysql)
        
Descrição
          Se existem mais resultados da consulta,
          mysql_next_result() lê o próximo
          resultado da consulta e retorna o status a aplicação.
          Disponível no MySQL 4.1
        
          Note que você deve chamar
          mysql_free_result() para a consulta
          anterior se ela retornar um resultado.
        
          Depois de chamar mysql_next_result() o
          estado da conexão é como se tivesse chamado
          mysql_real_query() para a prima consulta.
          Isto significa que você agora pode chamar
          mysql_store_result(),
          mysql_warning_count(),
          mysql_affected_rows() ... na conexão.
        
          Se mysql_next_result() retorna um erro,
          nenhuma outra instrução será executada e não haverá mais
          resultado para buscar.
        
See Secção 12.1.8, “Tratando a Execução de Múltiplas Consultas na API C”.
Valor Retornado
0 em caso de sucesso e haver mais resultados. -1 se não houver mais resultados. > 0 se ocorrer um erro.
Erros
              CR_COMMANDS_OUT_OF_SYNC
            
              Os comando foram executados em uma ordem inpropriada. Por
              exemplo se você não chamar
              mysql_use_result() para um resulatdo
              anterior.
            
              CR_SERVER_GONE_ERROR
            
O servidor MySQL foi finalizado.
              CR_SERVER_LOST
            
A conexão ao servidor MySQL foi perdida durante a consulta.
              CR_UNKNOWN_ERROR
            
Um erro desconhecido ocorreu.
This is a translation of the MySQL Reference Manual that can be found at dev.mysql.com. The original Reference Manual is in English, and this translation is not necessarily as up to date as the English version.

