DBaddInfo

Neues Attributelement anlegen.

Mit diesem Aufruf wird dem Objekt mit dem Handle object ein neues Attribut hinzugefügt. Diese Attribut ist ein Paar aus einem Namen (attrib) und einem Wert (wert). Als Name darf jeder ASCII-String verwendet werden. Der Wert besteht aus einer beliebigen Byte-Folge, deren Länge über den Parameter len angegeben wird. Es lassen sich hier also auch Binärdaten speichern. Innerhalb eines Objektes muss der Name des Info-Elementes (oder auch Attributes) eindeutig sein. Wenn versucht wird, ein zweites Info-Element mit demselben Namen zu erzeugen, wird dies als Fehler abgewiesen. Dafür dürfen Attributwerte beliebig lang sein (sofern sie in den Speicher passen).

Parameter

object (POBJECT)                                     [IN]

Handle des Objektes, in dem das Attribut angelegt wird.

attrib (const char *)                                      [IN]

Name des neuen Attributs. Der Name des Attributs muss mindestens ein Zeichen lang sein. Das Maximum liegt bei 64k Zeichen.

wert (const void *)                                       [IN]

Dies sind beliebige Binärdaten. Wenn allerdings ein Objekt erzeugt wird, das mit VQL vom Anwender angezeigt werden kann, so sollte am Beginn des Attributwertes ein NULL-terminierter String existieren.

len (ULONG)                                               [IN]

Länge des Attributwertes. Diese Länge sollte bei Zeichenketten das abschließende NULL-Zeichen enthalten.

typ (USHORT)                                             [IN]

Indikator für die Art der gespeicherten Daten, dies ist eine der ATTRIBUT_TYP_*-Konstanten. Für Anwenderdaten wird normalerweise ATTRIBUT_TYP_TEXT verwendet. Intern wird etwa zum Speichern der Klassenstrukturen der Typ ATTRIBUT_TYP_RECORD verwendet.

Ergebnis

(PINFO_ELEMENT)                               [OUT]

Das Handle des Infoelements, das neu erzeugt wurde. Falls aufgrund eines Fehlers kein Element erzeugt wurde gibt die Funktion NULL zurück.

Deklaration

#include "database.h"

PINFO_ELEMENT DLLENTRY DBaddInfo(

     POBJECT           object,

     const char *      attrib,

     const void *      wert,

     ULONG          len,

     USHORT            typ

);

Historie

Datum      Autor  Beschreibung

10.2.1999  HW      Funktion beschrieben