DataDirect OpenAccess SDK Help

dam_createVal

Save PDF

dam_createVal

Save PDF

Last Updated: May 12, 2026
1 minute read

OpenAccess SDK
Version 8.1
Documentation

This method is used to build the output value of a scalar function. NULL data is added by specifying the XO_NULL_DATA value flag for the column value length. The data must be provided in the same format as the output of the scalar function or in any format for which a conversion is supported. Please refer to the following data conversion table:

https://documentation.progress.com/output/DataDirect/collateral/dataconversiontable.html

This method copies data from the user-supplied buffer to its internal buffers, so the IP can free the memory associated with the input buffer (colVal).

int64 dam_createVal(
int64 pMemTree,
int64 iXoType,
object colVal,
int64 iColValLen)

Parameters for dam_createVal

Parameter	Type	Description
IN
pMemTree	int64	The tree to use for allocating space.
iXoType	int64	The type of the data. Must be the type defined as the output for this scalar function.
colVal	object	The data object. The .NET type of the data should correspond to the iXoType value. See Table 33.
iColValLen	int64	The length of the data. XO_NULL_DATA – indicates a null value. For VARCHAR, CHAR and NUMERIC, either the number of characters or XO_NTS to add the entire string. For all other data types, pass in 0 or any value other than XO_NULL_DATA.
RETURN
	int	non-null – valid handle to the return value. null – error adding the value.