The function makes accessible the values of the structured variable row given by the parameter index. The structured variable is defined by the parameter refToStruct of HBJ type (for example: SV.Structure\HBJ). Value defined in the parameter index is not checked because of the size of the structured variable.
According to the parameter bAsync, the function is:
Asynchronous (bAsync = @TRUE) The function call is basically a request for updating the values of given row. Therefore the time, when the values will be updated depends on the total system load. Return value of the function is 0.
Synchronous (without the parameter bAsync, or bAsync = @FALSE) After terminating the function call, the values in the row are updated. Return value of the function is _ERR_NO_ERROR when it was successfully executed.
Note
For purposeful use of the function, there must be enabled filtering the structured variable values - creating an indexed local variable for the structured variable with enabled filtering.
Example
To make accessible the values in the row 5 of the structured variable SV.Structure:
INT _retCode
TEXT _errMsg
_retCode := %HI_OpenRow(SV.Structure\HBJ, 5)
IF _retCode # _ERR_NO_ERROR THEN
_errMsg := "%HI_OpenRow(SV.Structure\HBJ ErrorCode = " + %IToStr(_retCode)
ELSE ; values are accessible
ENDIF
0 komentárov