DBreturnInformationRecord

Top  Previous  Next

Ermitteln der Attributeinstellungen.

An jedem Element können beliebig viele Attribute angehangen werden. Mit DBfirstInformationRecord und DBnextInformationRecord können die Attribute ermittelt werden. Mit dieser Funktion kann aus dem Attribut der Wert und der Attributname ermittelt werden. Im Moment sind nur bei PROOT, PSEGMENT und PPLANS Attribute möglich.

Parameter

info (PINFORMATION)                              [IN]

Handle auf das Attribut.

name (char *)                                      [IN/OUT]

Es muss vorher ausreichend Speicher bereitgestellt werden. Anschließend steht der Attributname in name.

nameLen (int *)                                   [IN/OUT]

Länge des zur Verfügung gestellten Speichers von name. Wenn hier die Zahl 0 übergeben wird, wird die Länge selbst ermittelt. Ist in nameLen eine Zahl kleiner als die Länge des Attributnamen, werden auch nur so viele Zeichen in name kopiert. Ist nameLen größer als die Länge des Attributnamens, wird in name der gesamte Attributname kopiert und nameLen erhält die echte Attributnamenlänge.

Wenn name und/oder nameLen NULL enthalten, werden beide Werte nicht gefüllt.

wert (char *)                                        [IN/OUT]

Zeichenkette, die den Attributwert erhält. wert muss mit ausreichend Speicher bereitgestellt werden.

wertLen (int *)                                     [IN/OUT]

In wertLen steht nachher auf jeden Fall die reale Länge von wert. Ansonsten gilt hier das gleiche wie bei nameLen.

Wenn wert und/oder wertLen NULL enthalten, werden beide Werte nicht gefüllt.

Ergebnis

---

Deklaration

#include "database.h"

 

void DLLENTRY DBreturnInformationRecord (

     PINFORMATION      info,

     char *            name,

     int *          nameLen,

     char *            wert,

     char *            wertLen

);

Verwandte Funktionen

DBfirstInformationRecord

DBnextInformationRecord

DBprevInformationRecord