%UIDToHBJ function

Function

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

Declaration

HBJ %UIDToHBJ(
  TEXT in objUID
 )

Parameters

objUID

An expression.

Description

The function sends a demand to D2000 Server and finds an object unique identifier (HOBJ) according to UID of object characterized by 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