DataDirect OpenAccess SDK Help

dam_getQueryFirstResultValue

Save PDF

Save PDF

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)

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 How the methods for Java return a value as an object.