DBfindChangeInfoElement

Den Inhalt eines Attributes ändern.

Dazu werden das Objekt und der Attributname, sowie der neue Wert des Attributs benötigt. Dann wird das Attribut gesucht und sein Inhalt auf den neuen Wert gesetzt. Wenn das Attribut nicht gefunden wird, wird eines mit diesem Namen angelegt und mit dem angegebenen Wert belegt. Der Anwender braucht sich nicht um Längenbegrenzungen kümmern, da das System automatisch genügend Speicherplatz für den neuen Wert zu Verfügung stellt. Wenn schon ein Handle des Attributs vorhanden ist, kann statt dessen die schnellere Prozedur DBchangeInfoElement benutzt werden.

Parameter

object (POBJECT)                                     [IN]

Handle des Objekts, dessen Attribut verändert werden soll. Wenn an diesem Objekt kein Attribut mit dem angegebenen Namen existiert, wird ein solches angelegt.

attrib (char *)                                                [IN]

Dies ist der Name des Attributs, das verändert werden soll. An jedem Objekt sind die Namen der Attribute eindeutig.

wert (void *)                                                 [IN]

Zeiger auf den neuen Inhalt. Dies kann jeder beliebige Inhalt sein und ist nicht auf Strings beschränkt. Wenn die neue Länge 0 ist, wird dieser Zeiger nicht benutzt.

len (ULONG)                                               [IN]

Die Länge des neuen Attributwerts.

attributArt (USHORT)                                  [IN]

Art des Attributs. Die Art wird mit abgespeichert und dient der Interpretation der Werte. Die möglichen Werte stehen in der Attributarten-Tabelle.

Ergebnis

(PINFO_ELEMENT)                               [OUT]

Handle des Elements, das geändert wurde. Oder NULL, falls die Änderung nicht erfolgreich war.

Deklaration

#include "database.h"

PINFO_ELEMENT DLLENTRY DBfindChangeInfoElem(

     POBJECT     object,

     char *      attrib,

     void *      wert,

     ULONG    len

     USHORT      attributArt

);

Verwandte Prozeduren

DBaddInfo

DBchangeInfoElement