DBfindChangeInfoElement

The contents of an attribute change.

The object and the attribute name, as well as the new value of the attribute become this required. Then the attribute is searched and his contents are put on the new value. If the attribute is not found, one is put on with this name and is booked with the given value. The user does not need himself around length limitations concern, because the system puts automatically enough storage space for the new value at possession. If already a trading of the attribute exists, the quicker procedure DBchangeInfoElement can be used instead of this.

Parametre

object (POBJECT) [IN]

Act of the object whose attribute should be changed. If in this object no attribute with the given name exists, such is put on.

attrib (char *) [IN]

This is the name of the attribute which should be changed. In every object the names of the attributes are unequivocal.

worth (void *) [IN]

Pointer on the new contents. This can be every any contents and is not limited to string. If the new length 0 is, this pointer is not used.

len (ULONG) [IN]

The length of the new attribute value.

attributArt (USHORT) [IN]

Kind of the attribute. The kind is stored away with and serves the interpretation of the values. The possible values stand in the attribute kind table.

Result

(PINFO_ELEMENT) [OUT]

Act of the element which was changed. Or ZERO, if the change was not successful.

Declaration

#include "database.h"

PINFO_ELEMENT DLLENTRY DBfindChangeInfoElem (

POBJECT object,

char * attrib,

void * worth,

ULONG len

USHORT attributArt

);

Related procedures

DBaddInfo

DBchangeInfoElement