DBinsertInfo

Top  Previous  Next

Add of an attribute value.

Every element can own arbitrarily many attributes. With this function a new attribute can be added. If the attribute with the name attrib already exists, it is not taken up once more.

Parametre

elem (PELEMENT) [IN]

Act on element which should get new attribute.

attrib (const char *) [IN]

Name of the attribute under which the value can be found again.

worth (const void *) [IN]

This are any binary data. If, however, an object is generated which can be indicated with VQL by the user, a Zero-timed string should exist at the beginning of the attribute value.

len (ULONG) [IN]

Length of the attribute value. This length should contain the final zero sign with sign chains.

typ (USHORT) [IN]

Indicator for the kind of the stored data, this is one of the ATTRIBUT_TYP_* constants. For user data it is ordinarily used ATTRIBUT_TYP_TEXT. Inside the type ATTRIBUT_TYP_RECORD is used possibly to the memory of the class structures.

Result

(PINFO_ELEMENT) [OUT]

The trading of the Infoelements which was anew generated. If on account of a mistake no element was generated or the attribute already exists, the function returns ZERO.

Declaration

#include "database.h"

 

PINFO_ELEMENT DLLENTRY DBinsertInfo (

PELEMENT elem,

const char * attrib,

const void * worth,

ULONG len,

USHORT typ

);

Related functions

DBaddInfo