26.14. 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
Parameter block.
e
Entry that you want to test.
f
Filter that you want to test the entry against.
verify_access
If 1, verifies that the current user has access rights to search the specified entry. If 0, bypasses any access control.
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.