dam_isTargetRow

This method 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 not. If DAM_TRUE, call dam_addRowToTable. If DAM_FALSE, call dam_freeRow to free the row.

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