Netscape DIRECTORY SERVER 6.02 - PLUG-IN Manual page 248

Functions for Syntax Plug-In
The function invokes the syntax plug-in specified by the
plug-in associated with the type of attribute used in the search. You can get this
handle by calling the
The syntax plug-in function invoked by this function is responsible for comparing
the value specified by
entries. The syntax plug-in function returns a list of matching entry keys (the
argument) to the backend.
slapi_call_syntax_assertion2keys_sub_sv()
When processing a search, calls the function (defined in the specified syntax
plug-in) responsible for returning an array of values (specified by the search filter)
to compare against the entries in the directory.
This function applies to searches that use the filter type
Syntax
#include "slapi-plugin.h"
int slapi_call_syntax_assertion2keys_sub_sv( void *vpi,
char *initial, char **any, char *final, Slapi_Value ***ivals );
Parameters
This function takes the following parameters:
vpi
initial
any
final
ivals
248 Netscape Directory Server Plug-In Programmer's Guide • May 2002
slapi_attr_type2plugin()
against the actual values of the attributes in the directory
val
Handle to plug-in for this attribute type
"Starts with" value from the search filter (for example, if the
filter is ou=Sales*, the argument initial is Sales)
Array of "contains" values from the search filter (for example, if
the filter is ou=*Corporate*Sales*, the argument any is an
array containing Corporate and Sales)
"Ends with" value from the search filter (for example, if the filter
is ou=*Sales, the argument final is Sales)
Pointer to an array of Slapi_Value structures containing the
values returned by the plug-in function (these values can now be
compared against entries in the directory).
argument. (This is the
vpi
function.)
LDAP_FILTER_SUBSTRINGS
ivals
.