UrmOpen

UrmOpen(int1, int2, alpha3) : handle

Benutzerobjekt öffnen

Details

• int1:
  • Typ:
  • _UrmTypeUser
  • _UrmTypeUserGroup
  • _UrmTypeElmGroup
• int2:
  • Sperrmodus:
  • 0
  • _UrmLock
  • _UrmStrict
• alpha3: Objektname
• Resultat: handle Deskriptor oder Fehlerwert
• Siehe: Verwandte Befehle , Benutzerpflege , UrmClose ()

Mit dieser Anweisung kann ein Objekt aus der Benutzerverwaltung geöffnet werden. Der Typ des zu öffnenden Objekts muss in (int1) übergeben werden. Folgende Objekte können geöffnet werden:

• _UrmTypeUser: Benutzer
• _UrmTypeUserGroup: Benutzergruppe
• _UrmTypeElmGroup: Elementgruppe

Über den Parameter (int2) kann eine Sperre eingerichtet werden. Im Gegensatz zu Datensatzsperren kann das Objekt auch ohne eine Sperre verändert werden. Das Löschen eines gesperrten Objekts ist allerdings nicht möglich. Das Setzen der Sperre kann zur Synchronisation mehrerer Clients dienen. Mit _UrmLock wird eine benutzerspezifische Sperre eingerichtet. Versucht der gleiche Benutzer noch einmal das Objekt zu sperren erfolgt keine Fehlermeldung.

Beim Öffnen eines Objekts kann ebenfalls eine strikte Rechtekontrolle aktiviert werden. Ein Benutzer hat normalerweise das Recht, eigene Eigenschaften zu lesen und zu verändern, sowie Eigenschaften seiner Benutzergruppen zu lesen. Durch die Angabe von _UrmStrict in (int2) werden diese Sonderrechte nicht berücksichtigt.

In (alpha3) wird der Name des Objekts angegeben. Der Name kann zuvor mit UrmRead () ermittelt werden.

Das Resultat der Anweisung ist entweder der Deskriptor des Objekts, oder einer der folgenden negativen Fehlerwerte:

• _ErrLocked: Objekt ist von einem anderen Benutzer gesperrt.
• _ErrUrmObjectNotFound: Das in (alpha3) angegebene Objekt kann nicht gefunden werden.

Beispiel

tHdl # UrmOpen(_UrmTypeUser, _UrmLock, 'SUPERUSER');
if (tHdl < 0)
{
  // Fehlerbehandlung
  ...
}
...
tHdl->UrmClose();

Mögliche Laufzeitfehler:

• _ErrValueInvalid: In (int1) wurde ein ungültiger Typ übergeben.
• _ErrStringOverflow: Der Objektname in (alpha3) ist zu lang.