Writing A Filter Index Function; Set The Slapi_Plugin_Mr_Oid; Slapi_Plugin_Object; Slapi_Pblock - Netscape DIRECTORY SERVER 6.02 - PLUG-IN Manual

Input and Output Parameters Available to a Filter Factory Function (Continued)
Table 11-4
Parameter Name

SLAPI_PLUGIN_PRIVATE

SLAPI_PLUGIN_MR_FILTER_MATCH_FN
SLAPI_PLUGIN_MR_FILTER_INDEX_FN
SLAPI_PLUGIN_DESTROY_FN

SLAPI_PLUGIN_OBJECT

Writing a Filter Index Function

The filter index function takes a single
never be called for the same filter object concurrently. (If you plan to manipulate
global variables, keep in mind that the server can call this function concurrently for
different filter objects.)
The filter index function should do the following:
Get the filter object from the
1.
parameter is set).
Using data from the object, determine and set the values of the following
2.
parameters:
Data Type
void *
mrFilterMatchFn
(function pointer)
void *
(function pointer)
void *
(function pointer)
void *
Set the

SLAPI_PLUGIN_MR_OID

matching rule.
Description
(Input parameter) Pointer to any
private data originally specified in
the initialization function. (See
"Writing an Initialization
Function" on page 143 for details.)
(Output parameter) Name of the
function called by the server to
match an entry's attribute values
against the value in the extensible
search filter.
(Output parameter) Name of the
function called by the server to
generate a list of keys used for
indexing a set of values.
(Output parameter) Name of the
function to be called to free the
filter object.
(Output parameter) Pointer to the
filter object created by your factory
function.
argument. This function will

Slapi_PBlock

SLAPI_PLUGIN_OBJECT
parameter to the official OID of the
Chapter 11
Handling Extensible Match Filters
parameter (if the
Writing Matching Rule Plug-Ins 139