dam_addCharValToRow
- Last Updated: May 12, 2026
- 1 minute read
- OpenAccess SDK
- Version 8.1
- Documentation
This function is used to build up a row by adding values for columns, one at a time. This function requires all data to be passed in using the same format as the column definition in the schema database 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
Character data can be added by supplying the length or by marking the data as null terminated. NULL data is added by specifying the XO_NULL_DATA value flag for the column value length.
These methods copy data from the user-supplied buffer to its internal buffers; therefore, the IP can free the memory associated with the input buffer (colVal).
int dam_addCharValToRow(
int64 hstmt,
int64 hRow,
int64 hCol,
String colVal,
int lColValLen)
Parameters for dam_addCharValToRow
| Parameter | Type | Description |
| IN | ||
| hstmt | int64 | The statement handle |
| hRow | int64 | The row handle |
| hCol | int64 | The column handle |
| colVal | depends on the method used | The type of the data should correspond to the iXoType value.The data can be supplied in a format that corresponds to the column's definition in the schema or in any other format and the OpenAccess SDK SQL engine will perform the required conversion. |
| IColValLen | int | The length of the data XO_NULL_DATA - indicates a null value For VARCHAR, CHAR, WVARCHAR, WCHAR, and NUMERIC, either the number of characters or XO_NTS to add the entire string. For all other data types, 0 or any value other than XO_NULL_DATA. |
| RETURN | ||
| int | DAM_SUCCESS - added the value to the row DAM_FAILURE - error adding the value |