DBaddMemberElementBySetname

Top  Previous  Next

Fügt zu einer Master-Member-Verbindung einen weiteren Member hinzu.

Für diese Prozedur muss sowohl das Masterobjekt bekannt sein, als auch der Name der Verknüpfung. Es ist hingegen nicht notwendig, dass das Element der Masterverknüpfung bekannt ist. Die Routine sucht dann im Masterobjekt nach der Master-Member-Verknüpfung mit diesem Namen und testet, ob das angegebene Member-Element noch nicht Member dieser Verknüpfung ist. Wenn es noch nicht Mitglied ist, wird es hinzugefügt. Wenn die Verknüpfung gar nicht existiert oder das neue Objekt schon Member der angegebenen Verknüpfung ist, wird NULL als Zeichen für einen aufgetretenen Fehler zurückgegeben.

Parameter

POBJECT master                                         IN

Handle des Masterobjekts, an das das Objekt Member angebunden werden soll.

POBJECT member                                      IN

Handle des Objekts, das als Member in der Verknüpfung setname an das Masterobjekt master geknüpft werden soll.

char *setname                                               IN

Name der Verknüpfung zwischen master und member.

Ergebnis

PMEMBER_ELEMENT                            OUT

Ist das Handle des Elements, das in das Member-Objekt eingefügt worden ist, um die Master-Member-Verbindung zu realisieren. Wenn ein Fehler aufgetreten ist, dann wird stattdessen NULL als Ergebnis geliefert.

Deklaration

#include "database.h“

 

PMEMBER_ELEMENT DLLENTRY   DBaddMemberElementBySetname(

                          POBJECT master,

                          POBJECT member,

                          char *setname

                    );