UrmPropSet

obj -> UrmPropSet(alpha1, var2) : logic

Setzen einer Eigenschaft in der Benutzerverwaltung

Details

• obj: Deskriptor des Objekts
• alpha1: Name oder Konstante der Eigenschaft
• var2: Wert
• Resultat: logic Ergebnis
• Siehe: Verwandte Befehle , UrmPropGet ()

Dieser Befehl setzt eine Eigenschaft eines Objekts der Benutzerverwaltung. Als (obj) wird der Deskriptor des Objekts angegeben. Der Deskriptor wird beim Öffnen des Objekts (UrmOpen ()) zurück gegeben.

In (alpha1) wird der Name der Eigenschaft angegeben. Bei den vordefinierten Eigenschaften (Systemproperties) der Objekte kann auch eine entsprechende Konstante angegeben werden. Die Konstante wird aus _UrmProp und dem Namen der Eigenschaft zusammengesetzt (siehe Eigenschaften von Objekten des Benutzersystems )

Der neue Wert der Eigenschaft wird in (var2) übergeben. Der Wert muss den gleichen Typ besitzen, wie die Eigenschaft. Der Typ der Eigenschaft kann mit Hilfe der Anweisung UrmPropType () ermittelt werden.

Damit eine Eigenschaft gesetzt werden kann, müssen verschiedene Bedingungen erfüllt sein: Die Eigenschaft muss vorhanden sein, der Benutzer muss über ausreichende Rechte zum Schreiben der Eigenschaft verfügen und die Eigenschaft muss beschreibbar sein. Der Erfolg der Anweisung kann über den Rückgabewert überprüft werden. Konnte der Wert der Eigenschaft gesetzt werden, wird true zurück gegeben. Ist ein Fehler aufgetreten, gibt die Anweisung false zurück. In diesem Fall kann der Fehlerwert mit ErrGet () abgefragt werden. Ein Fehler führt zum Verlassen eines try-Blocks.

Beispiel

if (!tHdlUser->UrmPropSet(_UrmPropActive, true))
{
  // Fehlerbehandlung
}

// benutzerdefinierte Eigenschaft setzen
tToday->vmSystemTime();
tHdlUser->UrmPropSet('LastLogin', tToday);

Mögliche Laufzeitfehler:

• _ErrHdlInvalid: Der übergebene Deskriptor in (obj) ist ungültig.
• _ErrNameInvalid: Die in (alpha1) angegebene Eigenschaft ist nicht vorhanden.
• _ErrType: Die Variable in (var2) hat einen anderen Typ als die Eigenschaft.