DBreturnSymbolSettings

Informationen zu einem Symbol

Zu einem Handle für ein Symbol werden die Informationen wie Position und Symbolnummer ermittelt. Dazu werden vom Anwender das Handle und eine Struktur vom Typ SYMBOL_SETTINGS bereitgestellt. In diese Struktur werden dann die Informationen geschrieben. Es ist nicht relevant, ob diese Struktur statisch oder dynamisch angelegt wird.

Parameter

symbol (PSYMBOL_ELEMENT)               [IN]

Dies ist das Handle eines Symbols. Von diesem Symbol sollen die Verwaltungsinformationen wie Position und id ermittelt werden.

settings (SYMBOL_SETTINGS *)    [IN/OUT]

Der Anwender stellt eine Struktur vom Typ SYMBOL_SETTINGS zur Verfügung, in die diese Prozedur die Daten des Symbols schreibt. Der Speicherplatz kann statisch oder dynamisch sein und wird vom Anwender verwaltet.

stufe (int)                                                      [IN]

Reserviert, muss 1 sein.

Wenn weitere Informationen eingeführt werden, werden diese über stufe unterschieden.

Ergebnis

(T_ERROR)                                            [OUT]

Wenn die Prozedur fehlerfrei ausgeführt werden konnte, dann liefert sie ERROR_OK, sonst eine der Fehlermeldungen aus error.h.

Deklaration

#include "database.h"

T_ERROR DLLENTRY DBreturnSymbolSettings (

     PSYMBOL_ELEMENT      symbol,

     SYMBOL_SETTINGS *    settings,

     int                  stufe

);