OpenAccess SDK SQL Engine Core Functions API : Function Reference : dam_isTargetRowForConditionList

dam_isTargetRowForConditionList

The IP can use this function to verify if the target row matches the input condition list. It returns DAM_TRUE if the row matches the condition list and DAM_FALSE if it does not.

This function is useful when the IP uses UNION condition lists (IP_SUPPORT_UNION_CONDLIST is set to 1) and builds target rows for each of the condition list returned from dam_getSetOfConditionListsEx. The IP can call this function to verify if the current row was already processed for any of the previous condition lists to avoid duplicate records being returned in the result set.

When using this function, the IP should not call dam_setOption to turn off the processing on the condition list.

int dam_isTargetRowForConditionList(
DAM_HSTMT hstmt,
DAM_HROW hrow,
DAM_HCONDLIST hCondList)

Table 169. Parameters for dam_isTargetRowForConditionList
Parameter	Type	Description
IN
hstmt	DAM_HSTMT	Statement handle.
hRow	DAM_HROW	Row handle.
hCondList	DAM_HCONDLIST	Condition list handle.
RETURN
	Int	DAM_TRUE - The row matches the condition list. DAM_FALSE - The row does not match the condition list. DAM_ERROR - The row handle is invalid or the operation is not supported.

dam_isTargetRowForConditionList

See also