mysql_next_result()
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 MariaDB 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 "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_SYNCOs comando foram executados em uma ordem inpropriada. Por exemplo se você não chamar
mysql_use_result()para um resulatdo anterior.CR_SERVER_GONE_ERRORO servidor MariaDB foi finalizado.
CR_SERVER_LOSTA conexão ao servidor MariaDB foi perdida durante a consulta.
CR_UNKNOWN_ERRORUm erro desconhecido ocorreu.