The mi_qual_setvalue() accessor function

Syntax

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.

Usage

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.

Return values

None