Zum Hauptinhalt springen

UrmPropGet

obj -> UrmPropGet(alpha1, var2) : logic​

Ausführbar von Clients mit grafischer Oberfläche Ausführbar vom Server Ausführbar von Clients mit Programmierschnittstelle Ausführbar von der Web-Schnittstelle Ausführbar vom Druckprozessor Ausführbar von der ODBC-Schnittstelle Ausführbar vom SOA-Service

Lesen einer Eigenschaft in der Benutzerverwaltung

Details

Dieser Befehl liest eine Eigenschaft eines Objekts der Benutzerverwaltung aus. 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 vom System definierten 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 Wert der Eigenschaft wird in der Variable (var2) gespeichert. Die Variable muss den gleichen Typ besitzen, wie die Eigenschaft. Der Typ der Eigenschaft kann mit Hilfe der Anweisung UrmPropType () ermittelt werden.

Der Erfolg der Anweisung kann über den Rückgabewert überprüft werden. Konnte der Wert der Eigenschaft ausgelesen 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->UrmPropGet(_UrmPropName, tUsername))
{
  // Fehlerbehandlung
}

Mögliche Laufzeitfehler:

  • _ErrHdlInvalid: Der angegebene Deskriptor in (obj) ist ungültig.
  • _ErrNameInvalid: Der in (alpha1) angegebene Name ist nicht vorhanden.
  • _ErrType: Die in (var2) angegebene Variable hat nicht den gleichen Typ wie die Eigenschaft.