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

Functions for Sending Entries and Results to the Client

slapi_send_ldap_result()

Sends an LDAP result code back to the client.
Syntax
#include "slapi-plugin.h"
void slapi_send_ldap_result( Slapi_PBlock *pb, int err,
char *matched, char *text, int nentries,
struct berval **urls );
Parameters
This function takes the following parameters:
pb
err
matched
text
nentries
urls
Description
Call
LDAP_SUCCESS
The following arguments are intended for use only in certain situations:
•
matched
When sending an
matched
database. For example, if the client was attempting to find the DN:
488 Netscape Directory Server Plug-in Programmer's Guide • October 2004
Parameter block.
LDAP result code that you want sent back to the client; for example,
LDAP_SUCCESS.
When sending back an LDAP_NO_SUCH_OBJECT result code, use
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
do not want an error message sent back.
When sending back the result code for an LDAP search operation,
use this argument to specify the number of matching entries found.
When sending back an LDAP_PARTIAL_RESULTS result code to an
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.
slapi_send_ldap_result()
) back to the client.
LDAP_NO_SUCH_OBJECT
to specify how much of the target DN could be found in the
cn=Babs Jensen, ou=Product Division, o=Example, c=US
to send an LDAP result code (such as
result code back to a client, use