DBelementFromGradisId

Handle eines Elements ermitteln.

Zu einer gradiskonformen ID wird das Handle des einsprechenden Elements ermittelt. Eine gradiskonforme ID ist eine 2 mal 16 Bit lange Zahl, wobei die erste Zahl das Objekt, die zweite Zahl das Element bestimmt. Diese ID überlebt das Sichern nicht. Es dürfen daher keine Gradis-ID´s über das Sichern und Laden hinaus gespeichert werden. Dies ist nur mit normalen ID´s möglich. Nicht jedes Element besitzt eine Gradis-ID. Diese wird erst dann angelegt, wenn sie benötigt wird.

Parameter

root (PROOT)                                             [IN]

Das Handle der Datenbank

elementID (GRADISELEMENTID)           [IN]

Dies ist die 2*16 Bit lange ID des Elements. Zu diesem Element wird das Handle ermittelt.

Ergebnis

(PELEMENT)                                          [OUT]

Das Ergebnis ist im Falle der fehlerfreien Ausführung das Handle des Elements, das zu der gegebenen Gradis-ID gehört. Falls ein Fehler aufgetreten ist, wird ein NULL-Handle als Ergebnis geliefert.

Deklaration

#include "database.h"

PELEMENT DLLENTRY DBelementFromGradisId(

     PROOT          root,

     GRADISELEMENTID   elementID

);