Netscape NETSCAPE DIRECTORY SERVER 6.2 - GATEWAY CUSTOMIZATION, Manual

Page: 363 / 612

Functions for Dealing with Filters
Chapter 15 Function Reference 363
slapi_filter_test_ext()
Determines if an entry matches a given filter.
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:
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.
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.
See Also
slapi_filter_test_simple()
slapi_filter_test()
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.