%UIDToHBJ function


Function
The function returns a unique identifier to an object (HOBJ), defined by its UID (64 character string) in the system.
Declaration


HBJ %UIDToHBJ(
  TEXT in objUID
 )
Parameters


objUIDAn expression.
Description
The function sends a demand to the D2000 Server and finds an object unique identifier (HOBJ) according to UID of object characterized by the parameter objUID. If the object does not exist or the parameter is an invalid value, the function will return an invalid value.
Example


 INT _hbj
 TEXT _uid
 
 _uid := %HBJToUID(Sec\HBJ)
 
 _hbj := %UIDToHBJ(_uid)
 
 IF _hbj # Sec\HBJ THEN
  ; an error (the condition must not be fulfilled)
  _hbj := 0
 ENDIF