skip to main content
OpenAccess SDK SQL Engine core methods for Java : Exchanging data : dam_getQueryFirstResultValue
 

dam_getQueryFirstResultValue

This method returns the first result value of the subquery. It is used by the IP to get the result values of the subquery.
Object dam_getQueryFirstResultValue(
       long   hquery,
       xo_int piXoType,
       xo_int piValLen,
       xo_int piValStatus)
Table 211. Parameters for dam_getQueryFirstResultValue
Parameter
Type
Description
INPUT
hquery
long
The subquery handle.
OUTPUT
piXoType
xo_int
The data type of the result value.
piValLen
xo_int
The length of the data pointed to by *ppVal:
XO_NULL_DATA - null data.
XO_NTS - null terminated string.
>= 0 - length of the data.
piValStatus
xo_int
The status of the method call:
DAM_SUCCESS - all data retrieved.
DAM_NO_DATA_FOUND - no results are available. Result set is empty.
DAM_FAILURE - error in getting the data. Most likely the data cannot be converted to the XO_Type asked for.
RETURN
The object that represents the data portion of the result value. The format of the data depends on the type of the data type returned in piXoType. Use this object only if the piValLen is not set to XO_NULL_DATA. See Table 34.