DBaddMasterElement |
Top Previous Next |
|
Master-Element an Objekt anfügen. Eine Master-Member-Verbindung stellt eine Beziehung zwischen einem Objekt als Master und mehreren Objekten als Member her. Diese Beziehung hat einen Namen. Jedes Objekt kann nur eine Beziehung als Master mit diesem Namen besitzen. Es kann aber gleichzeitig eine Master und eine Member-Beziehung unter dem gleichen Namen besitzen. Ebenso kann ein Objekt mehrere Master-Verbindungen und mehrere Member-Verbindungen haben. Die Reihenfolge der Member-Objekte in einer Verbindung ist beständig. Zu einem Objekt mit einer Master-Verbindung lassen sich die Member-Objekte aufzählen. Ebenso lässt sich zu einem Member der zugehörige Master finden. Wenn der Master gelöscht wird, dann werden auch alle Member gelöscht, die in diesem Master vorhanden waren. Dies geschieht auch, wenn nur das Element gelöscht wird, das eine Master-Member-Verbindung repräsentiert. Ein Master-Objekt kann nicht gleichzeitig Member dieser Verbindung sein. Ein Member kann nicht mehrfach Member derselben Master-Member-Verbindung sein. DBaddMasterElement eröffnet eine neue Master-Member-Verbindung. Diese ist zum Zeitpunkt des Erzeugens leer, d.h. es existieren keine Member-Objekte zu diesem Master. Die Verbindung wird im Objekt object angelegt und erhält den Namen name. Wenn schon eine solche Verbindung in diesem Objekt existiert, wird eine Fehlermeldung erzeugt. Parameter object (POBJECT) [IN] Die neue Master-Verbindung wird in diesem Objekt angelegt. Das Objekt darf noch nicht Master einer Verbindung mit diesem Namen sein. set (PSET_ELEMENT) [IN] Die neue Verbindung erhält diesen Namen. Ergebnis (PMASTER_ELEMENT) [OUT] Wenn die Verbindung angelegt werden konnte, dann ist dies das Handle des neu erzeugten Elements. Sonst wird ein NULL-Handle als Ergebnis geliefert. Deklaration #include "database.h"
PMASTER_ELEMENT DLLENTRY DBaddMasterElement ( POBJECT object, PSET_ELEMENT set );
Verwandte Funktion
|