Netscape DIRECTORY SERVER 6.1 - PLUG-IN Manual page 470

Functions for Managing DNs
dn
base
scope
Returns
This function returns non-zero if
scope.
Description
This function carries out a simple test to check whether the DN passed in the
parameter is actually in scope of the base DN according to the values passed into
the
scope
See Also
slapi_sdn_compare()
slapi_sdn_isparent()
slapi_sdn_issuffix()
slapi_sdn_set_dn_byref()
Sets a DN value in a
Syntax
#include "slapi-plugin.h"
Slapi_DN *slapi_sdn_set_dn_byref(Slapi_DN *sdn, const char *dn);
Parameters
This function takes the following parameters:
470 Netscape Directory Server Plug-In Programmer's Guide • August 2002
The DN of the entry subject of scope test.
The base DN to which dn is going to be tested against.
The scope tested. This parameter can take one of the following
levels:
• LDAP_SCOPE_BASE - where the entry DN should be the
same as the base DN
• LDAP_SCOPE_ONELEVEL - where the base DN should be the
parent of the entry
• DN LDAP_SCOPE_SUBTREE - where the base DN should at
least be the suffix of the entry DN
and parameters.
base
structure.
Slapi_DN
matches the scoping criteria given by base and
dn
dn