getCurrentOSUser() - obsolet
Die Funktion getCurrentOSUser() liefert den Benutzernamen, den vollen Namen, die Beschreibung und Gruppen eines Windows-Benutzers. Obsolete Funktion, die Funktionen 1. getOSUser() und 2. getOSUserGroups() ersetzen die obsolete Funktion.
Synopsis
int getCurrentOSUser (string &username, string &fullname, string
&description, dyn_string &groups [, string password]);
Parameter
Parameter | Bedeutung |
&username | Der Benutzername des Windows-Benutzers |
&fullname | Der volle Name des Windows-Benutzers |
&description | Die Beschreibung des Windows-Benutzers |
&groups | Die Benutzergruppen zu denen der Windows-Benutzer gehört. |
password | Das Passwort des Benutzers. Dieser Parameter ist optional. Das Passwort ist jedoch erforderlich um die Gruppen des Benutzers zu bekommen. |
Rückgabewert
Integer.
Fehler
Die Funktion liefert -1 wenn ein Fehler auftritt und sonst 0.
Beschreibung
Die Funktion liefert den Benutzernamen, den vollen Namen, die Beschreibung und Gruppen eines Windows-Benutzers. Das Verhalten dieser Funktion wird über den optionalen Parameter password gesteuert. Ist password vorhanden, werden die Daten des Benutzers username zurückgegeben (falls username/password richtig sind). Ist password nicht angegeben, werden die Daten für den aktuell eingeloggten Benutzer zurückgegeben (in diesem Fall werden jedoch nicht die Gruppen, denen der Benutzer angehört, zurückgegeben).
Beispiel
main()
{
string user, full, desc, pass;
dyn_string group;
user="";
getCurrentOSUser(user, full, desc, group);
DebugN(user, full, desc, group);
}
// Liefert die Daten des aktuell eingeloggten Benutzers
Beispiel
main()
{
string user, full, desc, pass;
dyn_string group;
user="mdavis";
pass="password";
getCurrentOSUser(user, full, desc, group, pass);
DebugN(user, full, desc, group);
}
// Liefert die Daten des Benutzers "mdavis" mit Passwort "password"
Zuordnung
Benutzerverwaltung, wartende Control-Funktion
Verfügbarkeit
CTRL
Siehe auch
getAllOSGroups(), getAllOSUsers(), getCurrentDomainName(), getWindowsEvents() und verifyOSUser()