UrmDelete

obj -> UrmDelete(int1, alpha2) : int

Objekt der Benutzerverwaltung löschen

Details

• obj: Deskriptor des Eltern-Objekts oder 0
• int1:
  • Typ des Objekts:
  • _UrmTypeUser
  • _UrmTypeUserGroup
  • _UrmTypeElmGroup
  • _UrmTypeProperty
  • _UrmTypeMember
  • _UrmTypeElm
• alpha2: Name des Objekts
• Resultat: int Fehlerwert
• Siehe: Verwandte Befehle , Benutzerpflege , UrmCreate ()

Mit dieser Anweisung wird ein Objekt der Benutzerverwaltung gelöscht. Folgende Objekte können gelöscht werden:

• Benutzer Soll ein vorhandener Datenbank-Benutzer gelöscht werden, muss in (obj) 0 und in (int1) _UrmTypeUser übergeben werden. In (alpha2) wird der Name des Benutzers angegeben. Der Benutzer wird automatisch aus allen Benutzergruppen entfernt.
• Benutzergruppe Soll eine Benutzergruppe gelöscht werden, muss in (obj) 0 und in (int1) _UrmTypeUserGroup angegeben werden. Der Name der Benutzergruppe wird in (alpha2) übergeben. Die Liste der Benutzergruppen bei den einzelnen Benutzern wird automatisch aktualisiert.
• Elementgruppe Soll eine Elementgruppe gelöscht werden, muss in (obj) 0 und in (int1) _UrmTypeElmGroup angegeben werden. Der Name der Elementgruppe wird in (alpha2) angegeben. Die Elementgruppe wird automatisch bei allen Benutzergruppen entfernt.
• Eigenschaft Soll eine Eigenschaft gelöscht werden, muss das Objekt, dem die Eigenschaft gehört in (obj) übergeben werden. Das entsprechende Objekt muss zuvor mit UrmOpen () gelesen werden. In (int1) wird _UrmTypeProperty und in (alpha2) der Name der Eigenschaft übergeben. Eigenschaften, die vom System zur Verfügung gestellt werden, können nicht gelöscht werden.
• Mitgliedschaft Wird in (int1) der Typ _UrmTypeMember übergeben, kann damit ein Benutzer aus einer Benutzergruppe entfernt werden. Wird in (obj) eine Benutzergruppe übergeben, muss in (alpha2) der Name des Benutzers angegeben werden. Wird in (obj) ein Benutzer übergeben, muss in (alpha2) der Name der Benutzergruppe angegeben werden. Der in (obj) übergebene Deskriptor muss zuvor mit UrmOpen () geöffnet werden.
• Eintrag in einer Elementgruppe Soll ein Eintrag aus einer Elementgruppe entfernt werden, muss in (obj) der Deskriptor der Elementgruppe übergeben werden. Die Elementgruppe muss zuvor mit der Anweisung UrmOpen () gelesen worden sein. In (int1) wird der Typ des Eintrags mit einer _UrmTypeElm...-Konstante angegeben. Der Name des Eintrags wird in (alpha2) übergeben.

Über den Rückgabewert kann der Erfolg des Befehls überprüft werden:

• _ErrOk: Kein Fehler aufgetreten.
• _ErrRights: Der Benutzer verfügt nicht über ausreichende Rechte.
• _ErrType: In (alpha2) ist ein falscher Element-Typ angegeben worden.
• _ErrUrmParentNotFound: Das in (obj) übergebene Eltern-Objekt wurde nicht gefunden.
• _ErrUrmObjectNotFound: Das in (alpha2) übergebene Objekt wurde nicht gefunden.
• _ErrUnerasable: Das Objekt kann nicht gelöscht werden.
• _ErrLocked: Das Objekt ist von einem anderen Benutzer gesperrt.
• _ErrInUse: Bei (int1 = _UrmTypeUser ) wurde ein Benutzer angegeben, der zurzeit angemeldet ist.

Beispiel

// Benutzer löschen
tErg # UrmDelete(0, _UrmTypeUser, 'Sales1');

// Benutzer aus einer Benutzergruppe entfernen
tHdlUser # UrmOpen(_UrmTypeUser, _UrmLock, 'Sales1');
// Diesen Benuter aus der Gruppe Sales entfernen
tErg # tHdlUser->UrmDelete(_UrmTypeMember, 'Sales');
tHdlUser->UrmClose();

// Alternative zum Entfernen eines Benutzers
tHdlUserGroup # UrmOpen(_UrmTypeUserGroup, _UrmLock, 'Sales');
tErg # tHdlUserGroup->UrmDelete(_UrmTypeMember, 'Sales1');
tHdlUserGroup->UrmClose();

Mögliche Laufzeitfehler:

• _ErrHdlInvalid: Der in (obj) übergebene Deskriptor ist ungültig.
• _ErrValueInvalid: Der in (obj) übergeben Deskriptor hat den falschen Typ.
• _ErrStringOverflow: Der Objektname in (alpha2) ist zu lang.