DBreturnInformationRecord

Top  Previous  Next

Investigate of the attribute settings.

In every element many attributes angehangen can become arbitrarily. With DBfirstInformationRecord and DBnextInformationRecord if the attributes can be determined. With this function the value and the attribute name can be determined from the attribute. At the moment are possible only with PROOT, PSEGMENT and attributes PPLANS.

Parametre

info (PINFORMATION) [IN]

Act on the attribute.

name (char *) [IN / OUT]

Enough memory must be provided before. Afterwards the attribute name stands in name.

nameLen (int *) [IN / OUT]

Length of the provided memory from name. If here the number 0 hands over, the length is determined itself. Is smaller in nameLen a number than the length of the attribute name, even so many signs are copied in name. Is bigger nameLen than the length of the attribute name, the whole attribute name is copied in name and nameLen receives the real attribute name length.

If name and/or nameLen ZERO contain, become both Values not full.

worth (char *) [IN / OUT]

The sign chain which receives the attribute value. worth must be provided with enough memories.

wertLen (int *) [IN / OUT]

In wertLen the real length from worth stands after anyway. Otherwise is valid here same like with nameLen.

If worth and/or wertLen ZERO contain, become both Values not full.

Result

---

Declaration

#include "database.h"

 

void DLLENTRY DBreturnInformationRecord (

PINFORMATION info,

char * name,

int * nameLen,

char * worth,

char * wertLen

);

Related functions

DBfirstInformationRecord

DBnextInformationRecord

DBprevInformationRecord