DBgetVariableText

Eine Initialisierungsvariable als Text ermitteln.

In der Datenbank können initialisierte Variablen gespeichert werden. Dies sind im Grunde nur Zeichenketten, die mit einem Namen identifiziert werden. Die Werte werden mit der Funktion InitializeParameter/INI auf Benutzerebene vorgegeben. Auf Programmiererebene werden die Werte mit DBsetInitialValue... oder DBsetVariable... gesetzt. DBsetVariableText schreibt eine solche Initialisierung in die Datenbank. Funktionen wie DBsetInitialValueLong übergeben einen long-Wert, der mit der Funktion DBsetVariableText dann als Zeichenkette abgespeichert wird. Mit der Routine DBgetVariableText wird der Variablenwert ermittelt.

Parameter

root (PROOT)                                             [IN]

Handle auf die geöffnete Datenbank.

name (char *)                                               [IN]

Der Wert wird gesucht, der unter diesen Namen abgelegt ist.

value (char *)                                      [IN/OUT]

In value wird der Wert zurückgeliefert. value muss auf ausreichend großen Speicherbereich zeigen.

dfault (char *)                                               [IN]

Kann kein Eintrag unter dem Namen name gefunden werden, wird dieser Wert als Default-Wert in value zurückgeschrieben.

art (int)                                                          [IN]

Hat bei diesem Aufruf keine Bedeutung und kann deshalb beliebig sein.

Ergebnis

---

Deklaration

#include "database.h"

void DLLENTRY DBgetVariableText (

     PROOT    root,

     char *      name,

     char *      value,

     char *      dfault,

     int         art

);

Verwandte Funktionen

DBsetVariableText