DBobjectFromGradisId

Top  Previous  Next

Objekt aus einer Gradis-ID 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 Segment, die zweite Zahl das Objekt 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 Objekt besitzt eine Gradis-ID. Diese wird erst dann angelegt, wenn sie benötigt wird.

Parameter

root (PROOT)                                             [IN]

Das Handle der Datenbank.

objectID (GRADISOBJECTID)                 [IN]

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

Ergebnis

(POBJECT)                                             [OUT]

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

Deklaration

#include "database.h"

 

POBJECT DLLENTRY DBobjectFromGradisId (

     PROOT          root,

     GRADISOBJECTID    objectID

);