Netscape DIRECTORY SERVER 6.1 - PLUG-IN Manual page 183

Syntax
#include "slapi-plugin.h"
typedef int (*send_ldap_referral_fn_ptr_t)( Slapi_PBlock *pb,
Slapi_Entry *e, struct berval **refs, struct berval ***urls);
Parameters
The function has the following parameters:
Parameter block.
pb
Pointer to the Slapi_Entry structure representing the entry that you
e
are working with.
Pointer to the NULL-terminated array of berval structures containing
refs
the LDAP v3 referrals (search result references) found in the entry.
Pointer to the array of berval structures used to collect LDAP referrals
urls
for LDAP v2 clients.
Returns
0 if successful, or -1 if an error occurs.
Description
The
slapi_send_ldap_result()
referrals (search result references) back to the client. You can replace the function
that sends LDAP v3 referrals 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
In your plug-in initialization function, register your function by setting the
2.
SLAPI_PLUGIN_PRE_REFERRAL_FN
name of your function if you are using the pre-operation plug-in. If your are
using the post-operation plug-in, register your function by setting the
SLAPI_PLUGIN_POST_REFERRAL_FN
name of your function.
See
slapi_send_ldap_result()
sends LDAP v3 referrals to clients.
See Also
send_result()
function is responsible for sending LDAP v3
.
parameter in the parameter block to the
parameter in the parameter block to the
for information on the default function that
Chapter 14 Data Type and Structure Reference
Summary of Data Types and Structures
183