Red Hat DIRECTORY SERVER 7.1 - PLUG-IN PROGRAMMERS Manual page 495

When sending back an LDAP_NO_SUCH_OBJECT result code, use
matched
this argument to specify the portion of the target DN that could be
matched. Pass NULL in other situations.
Error message that you want sent back to the client. Pass NULL if you
text
do not want an error message sent back.
When sending back the result code for an LDAP search operation,
nentries
use this argument to specify the number of matching entries found.
When sending back an LDAP_PARTIAL_RESULTS result code to an
urls
LDAPv2 client or an LDAP_REFERRAL result code to an LDAPv3
client, use this argument to specify the array of berval structures
containing the referral URLs. Pass NULL in other situations.
Description
Call
slapi_send_ldap_result()
) back to the client.
LDAP_SUCCESS
The following arguments are intended for use only in certain situations:
•
matched
When sending an
to specify how much of the target DN could be found in the database.
matched
For example, if the client was attempting to find the DN
cn=Babs Jensen, ou=Product Division, l=US, dc=example,dc=com
and the database contains entries for
no entry for
ou=Product Division,l=US,dc=example,dc=com
set the parameter to
matched
l=US, dc=example,dc=com
•
urls
When sending an
client or an
LDAP_REFERRAL
specify the referral URLs.
For LDAPv3 referrals, you can call the
to LDAPv3 clients and collect them for LDAPv2 clients. You can pass the array
of collected referrals to the urls argument of
For example:
to send an LDAP result code (such as
LDAP_NO_SUCH_OBJECT
c=US
LDAP_PARTIAL_RESULTS
result code back to an LDAPv3 client, use
Functions for Sending Entries and Results to the Client
result code back to a client, use
and
l=US,dc=example,dc=com
result code back to an LDAPv2
slapi_str2filter()
slapi_send_ldap_results()
Chapter 15
but
, you should
to
urls
to send referrals
.
Function Reference 493