Specifies a referral callback function. The server calls this function when the internal search implemented to trigger this callback finds LDAP v3 referrals.
#include "slapi-plugin.h"
typedef int (*plugin_referral_entry_callback)(char * referral,
    void *callback_data);
The callback takes the following parameters.
Table 15–7 plugin_referral_entry_callback Parameters| Parameter | Description | 
|---|---|
| referral | URL of a reference found by the search. | 
| callback_data | Pointer passed to the internal search operation. Use this to pass your own data between the callback function and the body of the plug-in. | 
Pass this as the prec parameter of slapi_search_internal_callback_pb(). Each time the internal search finds a referral entry, it calls this function.
The server does not use the callback return value.