Zum Hauptinhalt springen

UrmDelete

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:

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: