getDomainOSUser()
Die Funktion getDomainOSUser() liefert die Domain, den Benutzernamen, den vollen Namen, die Beschreibung und die Gruppen des eingeloggten Windows-Benutzers zurück.
Synopsis
int getDomainOSUser(string &username, string &fullname, string &description, dyn_string &groups, string &domain, string password = "");
Parameter
Parameter | Bedeutung |
&username | Der Benutzername des eingeloggten Windows-Benutzers |
&fullname | Der volle Name des eingeloggten Windows-Benutzers |
&description | Die Beschreibung des eingeloggten Windows-Benutzers |
&groups | Die Benutzergruppen zu denen der eingeloggte Windows-Benutzer gehört. |
&domain | Die Domain des eingeloggten Windows-Benutzers. |
password | Ein optionaler Parameter der das Passwort des eingeloggten Windows-Benutzers angibt. Ein leeres Passwort wird standardmäßig übergeben. |
Rückgabewert
Integer. Die Funktion liefert 0, wenn sie erfolgreich ausgeführt wurde.
Fehler
Fehlende oder falsche Argumente
Beschreibung
Die Funktion getDomainOSUser() liefert die Domain, den Benutzernamen, den vollen Namen, die Beschreibung und die Gruppen des eingeloggten Windows-Benutzers. In einer Multi-Domain Umgebung in der es mehrere Domains gibt - z.B. eine Hauptdomain und eine Subdomain, können die Domain des eingeloggten Benutzers und die Domain des Rechners auf dem der Benutzer eingeloggt ist, unterschiedlich sein.
Die Funktion getDomainOSUser() ermittelt nicht nur die Daten des eingeloggten OS-Benutzers, sondern auch die Domain des Benutzers und liefert diese im String-Parameter „domain“ zurück.
Beispiel
Das Beispiel liefert die Domain, den Benutzernamen, den vollen Namen, die Beschreibung und die Gruppen des eingeloggten Windows-Benutzers zurück.
main()
{
string username;
string fullname;
string description;
dyn_string groups;
string domain;
string password;
int i = getDomainOSUser(username, fullname, description, groups, domain, password);
DebugN(username, fullname, description, groups, domain, password);
}
Zuordnung
Benutzerverwaltung
Verfügbarkeit
CTRL
Siehe auch