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 it does not. If DAM_TRUE, then call dam_addRowToTable. If DAM_FALSE, 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 method assumes that all rows provided by the IP satisfy the index conditions and does not perform further validation.