DBaddInfo

New attribute element put on.

With this call it is added to the object with the trading object a new attribute. This attribute is (worth a pair from a name (attrib) and a value. As a name every ASCII string may be used. The value exists of any byte result whose length about the parametre len is given. Binary data can be also stored here. Within an object the name of the info element (or also attribute) must be unequivocal. If it is tried to generate the second info element with the same name, this is turned down as a mistake. For it attribute values may be long arbitrarily (provided that they fit in the memory).

Parametre

object (POBJECT) [IN]

Act of the object in which the attribute is put on.

attrib (const char *) [IN]

Name of the new attribute. The name of the attribute must be long at least one sign. The maximum lies with 64k sign.

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 the function returns ZERO.

Declaration

#include "database.h"

PINFO_ELEMENT DLLENTRY DBaddInfo (

POBJECT object,

const char * attrib,

const void * worth,

ULONG len,

USHORT typ

);

History

Date author description

2/10/1999 function HW described