void mi_qual_setvalue(MI_AM_QUAL_DESC *qualDesc, 
   MI_AM_VALUE result_value);

qualDesc

points to the qualification descriptor.

result_value

indicates the result from executing the qualification.

MI_VALUE_TRUE indicates that the qualification is true.

MI_VALUE_FALSE indicates that the qualification is false.

MI_VALUE_NOT_EVALUATED indicates a pending evaluation.

The database server initializes all results in a qualification descriptor to MI_VALUE_NOT_EVALUATED. Typically, am_getnext makes a qualification test and then calls the mi_qual_setvalue() function to change result_value from MI_VALUE_NOT_EVALUATED to the test results (MI_VALUE_TRUE or MI_VALUE_FALSE).

When am_getnext sets all the qualifications that it can for a row, it calls the mi_eval_am_qual() function to handle any qualifications that it has not set. For an example, refer to Processing Complex Qualifications.

None

See the descriptions of accessor functions mi_eval_am_qual(), mi_init_am_qual(), mi_qual_boolop(), and mi_qual_qual().