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 LDAP_FILTER_SUBSTRINGS.

Syntax

#include "slapi-plugin.h"
int slapi_call_syntax_assertion2keys_sub( void *vpi, char *initial, char **any, char *final, struct berval ***ivals );

Parameters

The function has the following parameters:

vpi	Handle to plug-in for this attribute type
initial	"Starts with" value from the search filter (for example, if the filter is ou=Sales*, the argument initial is Sales)
any	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)
final	"Ends with" value from the search filter (for example, if the filter is ou=*Sales, the argument final is Sales)
ivals	Pointer to an array of berval structures containing the values returned by the plug-in function (these values can now be compared against entries in the directory)

Returns

0 if successful, or -1 if an error occurs (for example, if the corresponding function for the specified plug-in is not found).

Description

The ldbm backend (the default backend database) calls this function when processing searches in which the filter type is LDAP_FILTER_SUBSTRINGS.

The function invokes the syntax plug-in specified by the vpi argument. (This is the plug-in associated with the type of attribute used in the search. You can get this handle by calling the slapi_attr_type2plugin() function.)

The syntax plug-in function invoked by this function is responsible for comparing the values (specified by initial, any, and final) against the actual values of the attributes in the directory entries. The syntax plug-in function returns a list of matching entry keys (the ivals argument) to the backend.

Example

[To be added]

See Also