dam_createVal

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:

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).

Table 102: 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.