DBgetVariableLong

Eine Initialisierungsvariable als double ermitteln.

In der Datenbank können initialisierte Variablen gespeichert werden. Die Werte werden mit der Funktion InitializeParameter/INI auf Benutzerebene vorgegeben. Auf Programmiererebene werden die Werte mit DBsetInitialValue... oder mit DBsetVariable... gesetzt. DBsetVariableLong schreibt eine solche Initialisierung in die Datenbank. Mit der Routine DBgetVariableLong kann der Wert wieder ermittelt werden.

Parameter

root (PROOT)                                             [IN]

Handle auf die geöffnete Datenbank.

name (char *)                                               [IN]

Zeichenkette gibt den Namen an, unter dem die Variable abgelegt wird.

dfault (LONG)                                              [IN]

Wenn unter dem Variablennamen name kein Wert gefunden werden konnte, wird dieser Wert als Ersatzwert geliefert.

art (int)                                                          [IN]

Über die Flags in art soll der Zugriff auf die Variable gesteuert werden. Im Moment ist es noch nicht implementiert. Es gibt drei Konstanten, die die Art des Zugriffs regeln. Variablen können global gesetzt werden, d.h. sie sind frei zugänglich. Variablen können als versteckt gesetzt werden, d.h. sie sind nicht auf der Benutzerebene sichtbar (mit der Benutzerfunktion InitializeParameter). Oder sie sind als lokal gesetzt, dann sind sie nur für einzelne Funktionen sichtbar.

Ergebnis

(long)                                                       [OUT]

Es wird der Wert geliefert, der in der Variablen name gespeichert wurde. Konnte kein Variable mit dem Namen name gefunden werden, wird der Wert dfault als Ersatzwert geliefert.

Deklaration

#include "database.h"

long DLLENTRY DBgetVariableLong (

     PROOT    root,

     char *      name,

     LONG     dfault,

     int         art

);

Konstanten

VAR_ART_LOCAL

VAR_ART_GLOBAL

VAR_ART_HIDDEN

Verwandte Funktionen

DBsetVariableLong