The function GetObjectValue is use to get a current value of given object.

APIRET GetObjectValue(const char *name, HOBJ id, ObjectInfoPtr data)

The parameters name and id defines uniquely an object. One of them is required. If the parameter name is used, then id must equal to zero. Current value and status of defined object together with other information is returned in the structure data. If a value of the object is Text, Array or Structure types, the allocated memory for a value must be freed using the function FreeData.

Code	Description
API_OK	Object value was obtained correctly.
API_ObjNotExist	Required object doesn't exist.
API_TimeoutError	Object value was not obtained in defined time.
API_ParamError	The value of the parameter data is null.