Netscape DIRECTORY SERVER 6.1 - PLUG-IN Manual page 362

Functions for Dealing with Filters
Memory Concerns
No duplication of the filter is done, so this filter should not be freed independently
of the original filter.
See Also
slapi_filter_list_first()
slapi_filter_test()
Determines if the specified entry matches a particular filter.
Syntax
#include "slapi-plugin.h"
int slapi_filter_test( Slapi_PBlock *pb,
Slapi_Entry *e, Slapi_Filter *f, int verify_access );
Parameters
This function takes the following parameters:
pb
e
f
verify_access
Returns
This function returns one of the following values:
• 0 if the entry matched the filter or if the specified filter is NULL.
• -1 if the filter type is unknown.
• A positive value (an LDAP error code) if an error occurred.
See Also
slapi_filter_test_simple()
slapi_filter_test_ext()
362 Netscape Directory Server Plug-In Programmer's Guide • August 2002
Parameter block.
Entry that you want to test.
Filter that you want to test the entry against.
If 1, verifies that the current user has access rights to search the
specified entry. If 0, bypasses any access control.