my_bool mysql_change_user(MYSQL *mysql, const char
*user, const char *password, const char *db)
Beschreibung
Wechselt auf der durch mysql
angegebenen
Verbindung den Benutzer und macht die in db
angegebene zur (aktuellen) Standarddatenbank. In nachfolgenden
Anfragen ist diese Datenbank dann der Standardbezugsrahmen
für Tabellenverweise, die nicht explizit eine Datenbank
angeben.
mysql_change_user()
scheitert, wenn der
Benutzer sich nicht authentifizieren kann oder keine
Berechtigung zur Nutzung der Datenbank hat. In diesem Fall
werden Benutzer und Datenbank nicht geändert.
Der Parameter db
kann auf
NULL
gesetzt werden, wenn keine
Standarddatenbank vorgegeben werden soll.
Dieser Befehl veranlasst immer ein ROLLBACK
aller laufenden Transaktionen, schließt alle temporären
Tabellen, hebt Tabellensperren auf und setzt den Status so
zurück, als hätte jemand eine ganz neue Verbindung
aufgebaut. Das geschieht sogar dann, wenn der Benutzer nicht
wechselt.
Rückgabewerte
Null bei Erfolg und ein von null verschiedener Wert bei einem Fehler.
Fehler
Dieselben wie bei mysql_real_connect()
.
CR_COMMANDS_OUT_OF_SYNC
Befehle wurden in der falschen Reihenfolge ausgeführt.
CR_SERVER_GONE_ERROR
Der MySQL Server ist nicht mehr verfügbar.
CR_SERVER_LOST
Die Serververbindung brach während der Anfrage ab.
CR_UNKNOWN_ERROR
Ein unbekannter Fehler ist aufgetreten.
ER_UNKNOWN_COM_ERROR
Der MySQL Server implementiert diesen Befehl gar nicht (wahrscheinlich ein älterer Server).
ER_ACCESS_DENIED_ERROR
Benutzer oder Passwort ist falsch.
ER_BAD_DB_ERROR
Die Datenbank existiert nicht.
ER_DBACCESS_DENIED_ERROR
Der Benutzer hat keine Zugriffsrechte auf die Datenbank.
ER_WRONG_DB_NAME
Der Datenbankname war zu lang.
Beispiel
if (mysql_change_user(&mysql, "user", "password", "new_database")) { fprintf(stderr, "Failed to change user. Error: %s\n", mysql_error(&mysql)); }
Dies ist eine Übersetzung des MySQL-Referenzhandbuchs, das sich auf dev.mysql.com befindet. Das ursprüngliche Referenzhandbuch ist auf Englisch, und diese Übersetzung ist nicht notwendigerweise so aktuell wie die englische Ausgabe. Das vorliegende deutschsprachige Handbuch behandelt MySQL bis zur Version 5.1.