Slapi_Vattr_Filter_Test() - Netscape DIRECTORY SERVER 7.0 - PLUG-IN Manual

Functions for Dealing with Filters
Returns
This function returns one of the following values:
• A pointer to the
•
NULL
specified or if the filter syntax is incorrect.
When you are done working with this filter, you should free the
structure by calling

slapi_vattr_filter_test()

Tests a filter against a single entry.
Syntax
#include "slapi-plugin.h"
int slapi_vattr_filter_test( Slapi_PBlock *pb, Slapi_Entry *e,
struct 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
•
-1
• An LDAP error code (an integer greater than zero) if an error occurs.
376 Netscape Directory Server Plug-in Programmer's Guide • October 2004
Slapi_Filter
if the string cannot be converteted; for example, if an empty string is
slapi_filter_free()
Parameter block containing information about the filter.
Entry against which the filter is to be tested.
Filter against which the entry is to be tested.
Access control:
• 0 if access checking is not to be done; that is, bypass any
access control.
• 1 if access checking must be done; that is, verify that the
current user has access rights to search the specified entry.
if the filter matched.
if the filter did not match.
structure representing the search filter.
.
Slapi_Filter