mng.GetUserRoles

Dieser Job listet für den angemeldeten Benutzer oder einen angegebenen Benutzer die Systemrollen auf.

Ohne Angabe eines Benutzers werden die Systemrollen des angemeldeten Benutzers aufgelistet.

1. Eingabeparameter

Name Typ Pflicht Beschreibung

Flags

INT

Ja

z. Z. nicht unterstützt→ 0 übergeben

UserGUID

STRING

Ja

GUID des Benutzers. Leer bzw. GUID des angemeldeten Benutzers: keine Systemrolle erforderlich. GUID eines anderen Benutzers: Systemrolle 4 erforderlich.

[UserId]

STRING

Nein

ID des Benutzers; hat derzeit keine Funktion und wird vom Server ignoriert

2. Ausgabeparameter

Name Typ Abhängigkeit Beschreibung

Result

String

—

Liste mit den IDs der Systemrollen, durch Semikolon getrennt. Siehe Systemrollen.

3. Rückgabe

(INT): 0 = Job erfolgreich, sonst Fehlercode

4. Benötigte Systemrolle

Die Systemrolle wird nur beim Abfragen fremder Benutzer geprüft:

  • UserGUID weggelassen bzw. leer oder gleich der GUID des angemeldeten Benutzers — es wird keine Systemrolle benötigt; jeder Benutzer darf seine eigenen Systemrollen abfragen.

  • UserGUID eines anderen Benutzers — der aufrufende Benutzer benötigt die Systemrolle 4 (Administrator: Konfiguration Sicherheitssystem — Rechtesystem konfigurieren). Fehlt diese Rolle, wird der Aufruf mit dem Fehlercode -1040906164 abgewiesen; siehe Fehlercodes.

Eine Übersicht aller Rollen findet sich unter Systemrollen.