OASQLIP_free_colval
- Last Updated: May 12, 2026
- 1 minute read
- OpenAccess SDK
- Version 8.1
- Documentation
This function frees data that has been allocated to return data for a column. It is called after OASQLIP_get_colval. Generally, you reuse buffers until the entire result set is returned, but for columns that return DataChainList, free them after the column value is retrieved.
int OASQLIP_free_colval(
SQLIP_HSTMT sqlip_hstmt,
OADS_SMALLINT iXODataType,
OADS_POINTER pColVal)
Parameters for OASQLIP_free_colval
| Parameter | Type | Description |
| INPUT | ||
| sqlip_hstmt | SQLIP_HSTMT | Statement handle. |
| iXODataType | OADS_SMALLINT | Data type of the value in pColVal. |
| pColVal | OADS_POINTER | Pointer to a value of type iXODataType. For an XO_TYPE_LONGVARBINARY, XO_TYPE_LONGVARCHAR, or XO_TYPE_WLONGVARCHAR iXODataType, call sqlu_freeDataChainList to delete the list and its nodes. |
| RETURN | ||
| int | OADS_SUCCESS - successfully processed the call.OADS_ERROR - error in attempting to free resource. |