skip to main content
OpenAccess SDK SQL Engine Core Functions API : Function Reference : dam_getQueryFirstResultValue
 

dam_getQueryFirstResultValue

This function returns the first result value of the subquery. It is used by an IP to get the result values of the subquery.
int dam_getQueryFirstResValue(
DAM_HQUERY hquery,
int * piXoType,
void ** ppVal,
int * piValLen)
Table 149. Properties of dam_getQueryFirstResultValue
Parameter
Type
Description
IN
hquery
DAM_HQUERY
The subquery handle.
OUT
piXoType
int *
The data type of the result value.
ppVal
void **
The pointer to the data is returned in this location. The C type of the data corresponds to the iXoType value. See Table 33. Use this pointer only if the *piValLen is not set to XO_NULL_DATA. Do not attempt to free this data.
piValLen
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
RETURN
int
The status of the function 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.