The mi_qual_value() accessor function
The mi_qual_value() function retrieves the result of a qualification.
Syntax
MI_AM_VALUE mi_qual_value(MI_AM_QUAL_DESC *qualDesc);- qualDesc
- Points to the qualification descriptor.
Usage
To evaluate a nested qualification, the access method can use a recursive function. If a previous recursion set a value for the qualification with the mi_qual_setvalue() or mi_eval_am_qual() function, mi_qual_value() returns MI_TRUE or MI_FALSE.
The access method can use the mi_qual_value() to obtain the MI_TRUE or MI_FALSE value for each argument to a Boolean expression. If mi_qual_value returns MI_VALUE_NOT_EVALUATED, evaluate the corresponding qualification or pass it to mi_eval_am_qual().
Return values
- MI_TRUE
- Indicates a satisfied qualification.
- MI_FALSE
- Indicates one of the following:
- A previous function disqualified a column-argument value.
- A previous Boolean operation returned MI_FALSE.
- MI_VALUE_NOT_EVALUATED
- Indicates a qualification for which no results exist.