UrmRead

obj -> UrmRead(int1, int2[, alpha3]) : alpha

Objekt des Benutzer- und Rechtesystems lesen

Details

• obj: Deskriptor des Eltern-Objekts oder 0
• int1:
  • zu lesender Typ (abhängig von handle1):
  • _UrmTypeUser
  • _UrmTypeUserGroup
  • _UrmTypeElmGroup
  • _UrmTypeSysProperty
  • _UrmTypeProperty
  • _UrmTypeMember
  • _UrmTypePerm
  • _UrmTypeElm...
• int2:
  • Lesemodus:
  • 0
  • _UrmFirst
  • _UrmPrev
  • _UrmNext
  • _UrmLast
• alpha3: Objektname (optional)
• Resultat: alpha Name des gelesenen Objekts
• Siehe: Verwandte Befehle , Benutzerpflege

Dieser Befehl wird verwendet, um Objekte aus der Benuterverwaltung zu lesen. In Abhängigkeit des übergebenen Objekttyps werden unterschiedliche Informationen ausgelesen. Folgende Informationen können gelesen werden:

• Benutzer Um Benutzer zu lesen, wird als Eltern-Objekt (obj) 0 und in (int1) _UrmTypeUser übergeben. Der Rückgabewert ist der Anmeldename des Benutzers.
• Benutzergruppen Um die Benutzergruppen zu lesen, wird als Eltern-Objekt (obj) 0 und in (int1) _UrmTypeUserGroup übergeben. Der Rückgabewert entspricht dem Namen der Benutzergruppe.
• Elementgruppe Um die Elementgruppen zu lesen, wird als Eltern-Objekt (obj) 0 und in (int1) _UrmTypeElmGroup übergeben. Zurückgegeben wird der Name der Elementgruppe.
• Eigenschaften Um die Eigenschaften zu lesen, wird als Eltern-Objekt (obj) das auszulesende Objekt übergeben. Soll eine von CONZEPT 16 vordefinierte Eigenschaft gelesen werden muss in (int1) _UrmTypeSysProperty, soll eine benutzerdefinierte Eigenschaft gelesen werden, muss _UrmTypeProperty übergeben werden. Zurückgegeben wird der Name der Eigenschaft.
• Mitgliedschaften Um die Benutzer einer Benutzergruppe zu lesen, wird als Eltern-Objekt (obj) der Deskriptor der Benutzergruppe angegeben. Sollen die Benutzergruppen ermittelt werden, denen ein Benutzer angehört, wird als (obj) der Deskriptor des Benutzers angegeben. In (int1) wird _UrmTypeMember übergeben. Zurückgegeben wird der Name des Benutzers bzw. der Benutzergruppe.
• Rechte einer Benutzergruppe Um die Elementgruppen mit bestimmten Berechtigungen zu lesen, wird der Deskriptor der Benutzergruppe als (obj) und in (int1) _UrmTypePerm übergeben. Das Recht steht in (alpha3). Zurückgegeben werden alle Elementgruppen, auf die Rechte vergeben sind.
• Eintrag in einer Elementgruppe Um die Einträge einer Elementgruppe zu lesen, wird als Eltern-Objekt (obj) der Desktiptor der Elementgruppe und in (int1) eine _UrmTypeElm...-Konstante übergeben. Zurückgegeben wird der Name eines Eintrags.

In (int2) wird der Lesemodus übergeben. Soll das erste (_UrmFirst) oder das letzte Element (_UrmLast) gelesen werden, muss kein Referenz-Element in (alpha3) angegeben werden. Dies ist nur notwendig, wenn die Parameter _UrmPrev oder _UrmNext oder die Existenz eines Elements (int2 = 0) überprüft werden soll.

Zurückgegeben wird der Name des entsprechenden Elements. Konnte kein Objekt gefunden werden, wird ein Leerstring zurückgegeben.

Beispiele:

// Alle Benutzergruppen ermitteln
for   tUsrGrpName # UrmRead(0, _UrmTypeUserGroup, _UrmFirst);
loop  tUsrGrpName # UrmRead(0, _UrmTypeUserGroup, _UrmNext, tUsrGrpName);
while (tUsrGrpName != '')
{
  ...
}

// Alle Benuzter einer Benutzergruppe ermitteln
tHdlUsrGrp # UrmOpen(_UrmTypeUserGroup, _UrmLock, 'Sales');
for   tUsrName # tHdlUsrGrp->UrmRead( _UrmTypeMember, _UrmFirst);
loop  tUsrName # tHdlUsrGrp->UrmRead(_UrmTypeMember, _UrmNext, tUsrName);
while (tUsrName != '')
{
  ...
}

Mögliche Laufzeitfehler:

• _ErrHdlInvalid: Der in (obj) übergebene Deskriptor ist ungültig.
• _ErrValueInvalid: Der in (int1) angegebene Typ ist ungültig.
• _ErrStringOverflow: Der Objektname in (alpha3) ist zu lang.