The mi_qual_value() accessor function

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.