my_ulonglong mysql_insert_id(MYSQL *mysql)
        
Descrição
          Retorna o ID gerado para uma coluna
          AUTO_INCREMENT pela consulta anterior. Use
          esta função depois de ter realizado um consulta
          INSERT em uma tabela que contenha um campo
          AUTO_INCREMENT.
        
          Note que mysql_insert_id() retorna
          0 se a consulta anterior não gerar um
          valor AUTO_INCREMENT. Se você desejar
          salvar o valor para uso posterior, chame
          mysql_insert_id() imediatamente depois da
          consulta que gerou o valor.
        
          Se a consulta anterior retornar um erro, o valor de
          mysql_insert_id() é indefinido.
        
          mysql_insert_id() é atualizado depois de
          instruções INSERT e
          UPDATE que geram um valor
          AUTO_INCREMENT ou que definem um valor de
          coluna com LAST_INSERT_ID(expr). See
          Secção 6.3.6.2, “Funções Diversas”.
        
          Note também que o valor da função SQL
          LAST_INSERT_ID() sempre contém o o valor
          AUTO_INCREMENT gerado mais recentemente e
          não é zerado entre as consultas porque o valor desta
          função é mantido no servidor.
        
Valor Retornado
          O valor do campo AUTO_INCREMENT que foi
          atualizado pela consulta anterior. Retorna zero se não houve
          consultas anteriores na conexão ou se a consulta não
          atualizou o valor AUTO_INCREMENT.
        
Erros
Nenhum.
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.

