Netscape NETSCAPE DIRECTORY SERVER 6.2 - GATEWAY CUSTOMIZATION, Manual

Page: 68 / 612

Working with Search Filters
68 Netscape Directory Server Plug-In Programmer’s Guide • December 2003
Getting the Search Criteria
To get the search criteria specified by a search filter, call one of the following
functions:
• If the filter type is
LDAP_FILTER_EQUALITY
,
LDAP_FILTER_GE
,
LDAP_FILTER_LE
, or
LDAP_FILTER_APPROX
, you can get the attribute and
value used in the filter by calling
slapi_filter_get_ava()
.
• If the filter type is
LDAP_FILTER_PRESENT
, you can get the attribute type that
the filter is searching for by calling the
slapi_filter_get_type()
function.
• If the filter type is
LDAP_FILTER_SUBSTRINGS
, you can get the attribute type
that the filter searches for by calling
slapi_filter_get_subfilt()
.
• To get the components of a complex filter of the type
LDAP_FILTER_AND
,
LDAP_FILTER_OR
, or
LDAP_FILTER_NOT
, call the
slapi_filter_list_first()
and
slapi_filter_list_next()
functions.
Both of these functions will return either a filter component of the complex
filter or a NULL value, according to the following:
❍
If
slapi_list_first()
returns a NULL, the complex filter is not of the
type
LDAP_FILTER_AND
,
LDAP_FILTER_OR
, or
LDAP_FILTER_NOT
.
❍
If
slapi_list_next()
returns a NULL, the component returned by the
call is the last component in the complex filter.
LDAP_FILTER_GE
The search should find entries that contain a value
greater than or equal to the specified attribute value.
LDAP_FILTER_LE
The search should find entries that contain a value less
than or equal to the specified attribute value.
LDAP_FILTER_PRESENT
The search should find entries that contain the
specified attribute.
LDAP_FILTER_APPROX
The search should find entries that contain a value
approximately matching the specified attribute value.
NOTE
You do not need to free the values returned by the
slapi_filter_get_ava()
,
slapi_filter_get_type()
, and
slapi_filter_get_subfilt()
functions.
Table 5-4 Types of Filters (Continued)
Filter Type Description