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

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 with
e
which you are working.
Pointer to the NULL-terminated array of berval structures containing
refs
the LDAPv3 referrals (search result references) found in the entry.
Pointer to the array of berval structures used to collect LDAP referrals
urls
for LDAPv2 clients.
Returns
if successful, or if an error occurs.
0 -1
Description
The
slapi_send_ldap_result()
referrals (search result references) back to the client. You can replace the function
that sends LDAPv3 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 you 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 LDAPv3 referrals to clients.
See Also
send_result()
function is responsible for sending LDAPv3
.
parameter in the parameter block to the
parameter in the parameter block to the
for information on the default function that
Chapter 14
Summary of Data Types and Structures
Data Type and Structure Reference 191