32.9. slapi_mr_filter_index()

Calls the indexer function associated with an extensible match filter.
If the filter specified by the f argument is an extensible match filter, this function calls the indexer function associated with the filter.
Before calling this function, make sure that the parameter block pb contains the information needed by the indexer function. You can pass information to the indexer function by using the following parameters:
  • SLAPI_PLUGIN_MR_VALUES should contain a NULL-terminated list of values from the extensible match filter.
  • SLAPI_PLUGIN_OBJECT should contain information that you want to pass to the indexer function.
The indexer function should set the SLAPI_PLUGIN_MR_KEYS parameter of the parameter block pb to an array of the keys that correspond to the values in the SLAPI_PLUGIN_MR_VALUES parameter.
For more information on filter index functions and indexer functions, see Chapter 11, Writing Matching Rule Plug-ins.
Syntax

#include "slapi-plugin.h"
int slapi_mr_filter_index (Slapi_Filter *f, Slapi_PBlock *pb);

Parameters

This function takes the following parameters:

f
Pointer to a Section 14.23, “Slapi_Filter”structure, representing the extensible match filter for which you want to find the indexer function.
pb
Parameter block containing information about the extensible match filter.
Returns

This function returns the result code returned by the indexer function.