AdsClearSQLParams

Advantage Client Engine

Clears out parameters on this statement previously set using the AdsSet* APIs

Syntax

UNSIGNED32

AdsClearSQLParams( ADSHANDLE hStatement )

Parameters

hStatement (I)

Handle of an SQL statement created by a call to AdsCreateSQLStatement.

Remarks

Use AdsClearSQLParams to clear all values assigned to parameters and free their associated memory. If this function is not called, then parameter values will remain until the statement handle is closed. If the SQL statement text is changed via the AdsPrepareSQL function, then the old parameter values are assigned to the new statement’s parameters from left to right.

This method should be used to prevent the accidental use of old parameters with new statements and to free allocated resources. See AdsPrepareSQL for more details.

Example

Click Here

See Also

AdsPrepareSQL