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

Benutzerverwaltung