Advantage Client Engine
Sets constraint behavior for the statement handle
UNSIGNED32 |
AdsStmtConstrainUpdates ( ADSHANDLE hStatement, UNSIGNED16 usConstrain ) |
hStatement (I) |
Handle of an SQL statement created by a call to AdsCreateSQLStatement. |
usConstrain (I) |
Constraint value to set. Options are ADS_CONSTRAIN and ADS_NO_CONSTRAIN. |
The default value for newly created statement handles is ADS_NO_CONSTRAIN.
If AdsStmtConstrainUpdates is called with a value of ADS_CONSTRAIN the behavior of future cursors on this statement will change. Any row that is modified with the AdsSet functions (see AdsCreateSQLStatement) will undergo a WHERE clause verification on the server. If the row does not meet the WHERE clause that created the cursor, then the update will fail and an error will be returned. If the new row does meet the select criteria, then the update will occur normally.
Note There cannot be an open cursor associated with the statement when this API is called. If an open cursor exists close it using AdsCloseTable before calling this API.
None.