dam_isTargetRow

This function evaluates the row against the WHERE clause of the active SQL statement. It returns DAM_TRUE if the row matches the WHERE clause and DAM_FALSE if it does not. If DAM_TRUE, then call dam_addRowToTable. If DAM_FALSE is returned, then free the row by calling dam_freeRow.

DAM_ERROR is returned if the row handle is invalid or if all the required column values have not been set. In cases where the table had index(s) defined and the query contains restrictions on index columns, this function assumes that all rows provided by the IP satisfy the index conditions and does not perform further validation.