Netscape DIRECTORY SERVER 6.1 - PLUG-IN Manual page 184

Summary of Data Types and Structures
send_ldap_result_fn_ptr_t
send_ldap_result_fn_ptr_t
you can write to send LDAP result codes back to the client. You can register your
function so that it is called whenever the
called.
Syntax
#include "slapi-plugin.h"
typedef void (*send_ldap_result_fn_ptr_t)( Slapi_PBlock *pb,
int err, char *matched, char *text, int nentries,
struct berval **urls );
Parameters
The function has the following parameters:
pb
err
matched
text
nentries
urls
Description
The
slapi_send_ldap_result()
codes back to the client. You can replace the function that sends LDAP result codes
to the client with your own function. To do this:
Write a function with the prototype specified by
1.
send_ldap_result_fn_ptr_t
184 Netscape Directory Server Plug-In Programmer's Guide • August 2002
specifies the prototype for a callback function that
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.
Error message that you want sent back to the client. Use 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
LDAP v2 client or an LDAP_REFERRAL result code to an LDAP v3
client, use this argument to specify the array of berval structures
containing the referral URLs.
function is responsible for sending LDAP result
.
slapi_send_ldap_result()
function is