Netscape NETSCAPE DIRECTORY SERVER 6.2 - GATEWAY CUSTOMIZATION, Manual

Page: 138 / 612

Handling Extensible Match Filters
138 Netscape Directory Server Plug-In Programmer’s Guide • December 2003
5.
Set the following parameters:
❍
Set the
SLAPI_PLUGIN_MR_OID
parameter to the official OID of the
matching rule, if the value of that parameter is not the official OID
(optional).
❍
Set the
SLAPI_PLUGIN_OBJECT
parameter to the filter object.
❍
Set the
SLAPI_PLUGIN_MR_FILTER_INDEX_FN
parameter to the filter index
function (see “Writing a Filter Index Function” on page 139), if you have
set up indexes based on this matching rule (optional).
❍
Set the
SLAPI_PLUGIN_MR_FILTER_MATCH_FN
parameter to the filter
matching function. (See “Writing a Filter Matching Function” on page 141.)
❍
Set the
SLAPI_PLUGIN_DESTROY_FN
parameter to the function
responsible for freeing the filter object, if you have defined this function
(optional). See “Writing a Destructor Function” on page 143 for details.
6.
Return 0 (or the result code
LDAP_SUCCESS
) if everything completed
successfully.
Getting and Setting Parameters in Filter Factory
Functions
The following table summarizes the different parameters that the filter factory
function should get and set in the parameter block that is passed in:
Table 11-4 Input and Output Parameters Available to a Filter Factory Function
Parameter Name Data Type Description
SLAPI_PLUGIN_MR_OID char *
(Input parameter) Matching rule
OID (if any) specified in the
extensible match filter.
SLAPI_PLUGIN_MR_TYPE char *
(Input parameter) Attribute type (if
any) specified in the extensible
match filter.
SLAPI_PLUGIN_MR_VALUE struct berval *
(Input parameter) Value specified
in the extensible match filter.