26.15. slapi_filter_test_ext()

Determines if an entry matches a given filter.
Description

This function allows you to determine if an entry matches a given filter and/or that the current user has the permission to access the entry.

Syntax

#include "slapi-plugin.h"
int slapi_filter_test_ext( Slapi_PBlock *pb, Slapi_Entry *e, Slapi_Filter *f,int verify_access, int only_test_access)

Parameters

This function takes the following parameters:

pb
pblock from which the user is extracted.
e
The entry on which filter matching must be verified.
f
The filter used for filter matching.
verify_access
0 when access checking is not to be done.1 when access checking must be done.
only_test_access
0 when filter matching must be done.1 when filter matching must not be done.
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 or if the entry does not match the filter.
  • A positive value (an LDAP error code) if an error occurred or if the current user does not have access rights to search the specified entry.