my_bool mysql_change_user(MYSQL *mysql, const char *user, const char *password, const char *db)

Descrição

Altera o usuário é faz com que o banco de dados especificado por db se torne o banco de dados padrão (atual) na conexão especificada por mysql. Em consultas subsequentes este banco de dados é o padrão para referências a tabelas que não especificam o banco de dados explicitamente.

Esta função foi introduzida na versão do MySQL.

mysql_change_user() falha a menos que o usuário conectado possa ser autenticado ou se ele não tiver permissão para utilizar o banco de dodos. Neste caso o usuário e o banco de dados não são alterados.

O parâmetro db pode ser definido como NULL se você não dseseja ter um banco de dados padrão.

A partir da versão 4.0.6 do MySQL este comando sempre fará ROLLBACK de qualquer transação ativa, fecha todas as tabelas temporárias, destrava todas as tabelas bloqueadas e volta a um estado como se tivesse feito uma inova conexão. Isto irá acontecer mesmo se o usuário não foi alterado.

Valor Retornado

Zero se obteve successo. Diferente de zero se ocorreu um erro.

Erros

O mesmo que pode ser obtido com mysql_real_connect().

Exemplo

if (mysql_change_user(&mysql, "user", "password", "new_database"))
{
   fprintf(stderr, "Failed to change user.  Error: %s\n",
           mysql_error(&mysql));
}