dam_addColAliasValToRow
- Last Updated: May 12, 2026
- 2 minute read
- OpenAccess SDK
- Version 8.1
- Documentation
This function is used to build up a row by adding values for result columns based on Alias names.
The result column handle refers to column handles returned by dam_describeColResAlias.
This function requires the data to be passed in using the same data type as the column definition or in any format from which data conversion is supported. Character data can be added by specifying the length or marking the data as null terminated. NULL data is added by specifying the XO_NULL_DATA value flag for the column value length. This function copies data from the user supplied buffer to its internal buffers and therefore the IP can free the memory associated with the input buffer (pColVal).
int dam_addColAliasValToRow(
DAM_HSTMT hstmt,
DAM_HROW hRow,
DAM_HCOL hColAlias,
int iXoType,
void * pColVal,
long lColValLen)
Parameters for dam_addColAliasValToRow
| Parameter | Type | Description |
| IN | ||
| hstmt | DAM_HSTMT | The statement handle. |
| hRow | DAM_HROW | The row handle. |
| hCol | DAM_HCOL | The column handle returned from dam_describeColResAlias. |
| iXoType | int | Type of the data. The data can be supplied in a format that corresponds to the column's definition in the schema or in any other format. The OpenAccess SDK SQL engine will perform the required conversion. |
| pColVal | void * | A pointer to the data. The C type of the data should correspond to the iXoType value. See Table SQL Engine Data Types and the Corresponding C Types. |
| IColValLen | long | The length of the data: XO_NULL_DATA - indicates a null value. For VARCHAR, CHAR and NUMERIC either the length of the string or XO_NTS if the string is null terminated. For all other data types, the length of the data. Note: The length value is required so that OpenAccess SDK can validate that the correct size of data is passed in for the iXoType. |
| RETURN | ||
| int | DAM_SUCCESS - added the value to the row DAM_FAILURE - error adding the value |