Sun Java System Directory Server Enterprise Edition 6.0 Developer's Guide

send_ldap_referral_fn_ptr_t

Specifies a callback triggered before the server sends a result to the client.

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 callback takes the following parameters.

Table 15–11 send_ldap_referral_fn_ptr_t Parameters

Parameter 

Description 

pb

Current parameter block for the operation. 

e

Current entry for the operation. 

refs

Pointer to the NULL terminated array of berval structures containing the LDAP v3 referrals (search result references) found in the entry.

urls

Pointer to the array of berval structures used to collect LDAP referrals for LDAP v2 clients.

Description

This callback lets you modify referrals returned to the client. Register the callback with the server using slapi_search_internal_callback_pb() .

Returns

The callback should return 0 if successful, -1 otherwise.