The function returns the unique identifier (HOBJ) of the system object given by its name.
Declaration
Blok kódu
language
esl
theme
Confluence
HBJ%StrToHBJHBJ %StrToHBJ(
TEXT in objName
)
Parameters
objName
Text expression.
Description
The function sends a query to the process D2000 Serverprocess to detect the unique identifier of the system object defined by the parameter objName. If the object doesn't exist or the parameter is an invalid value, the function returns invalid value.
Example
Blok kódu
language
esl
theme
RDark
INT _hobj
_hobj := %StrToHBJ("Sec")
IF _hobj # Sec\HBJ THEN
; error (condition must not be met)
_hobj := 0
ENDIF
In the example, the object's HOBJ is detected in two ways.