Netscape Directory Server Programmer's Guide: Data Type and Structure Reference

Complete Contents
Getting Started
Chapter 1 Understanding Server Plug-Ins
Chapter 2 Writing and Compiling Plug-Ins
Chapter 3 Calling the Front-End API Functions
Chapter 4 Quick Start
Chapter 5 Writing Database Plug-Ins
Chapter 6 Writing Pre/Post-Operation Plug-Ins
Chapter 7 Defining Functions for LDAP Operations
Chapter 8 Defining Functions for Database Operations
Chapter 9 Defining Functions for Authentication
Chapter 10 Writing Entry Store/Fetch Plug-Ins
Chapter 11 Writing Extended Operation Plug-Ins
Chapter 12 Writing Matching Rule Plug-Ins
Chapter 13 Data Type and Structure Reference
Chapter 14 Function Reference
Chapter 15 Parameter Reference
Glossary

plugin_referral_entry_callback

plugin_referral_entry_callback specifies the prototype for a callback function. This function is called by the server when an internal search finds an entry that contains LDAP v3 referrals (search result references, which are normally sent back to the client as results found by the search) and if the client supports the LDAP v3 protocol (see "slapi_search_internal_callback()" on page 336 for details).

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

The function has the following parameters:
referral
Referral (in the form of an LDAP URL) found by the search.

callback_data
Pointer to the data specified by the callback_data argument in the slapi_search_internal_callback() function call.

Returns. 0 if successful or -1 if an error occurred.

© Copyright 1998 Netscape Communications Corporation