Sun Directory Server Enterprise Edition 7.0 Developer's Guide

plugin_referral_entry_callback

Specifies a referral callback function. The server calls this function when the internal search implemented to trigger this callback finds LDAP v3 referrals.

Syntax

#include "slapi-plugin.h"
typedef int (*plugin_referral_entry_callback)(char * referral,
    void *callback_data);

Parameters

The callback takes the following parameters.

Table 14–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. 

Description

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.

Returns

The server does not use the callback return value.