MI_AM_VALUE mi_qual_value(MI_AM_QUAL_DESC *qualDesc);

qualDesc

points to the qualification descriptor.

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().

For examples of recursive evaluation, refer to Processing Complex Qualifications.

MI_VALUE_TRUE indicates a satisfied qualification.

MI_VALUE_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.