DataDirect OpenAccess SDK Help

dam_getQueryFirstResultValue

Save PDF

Save PDF

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)

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 SQL Engine Data Types and the Corresponding C Types. 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.