Netscape DIRECTORY SERVER 6.2 - PLUG-IN Manual page 230

Functions for Internal Operations and Plug-In Callback
This function must have the prototype specified by
plugin_search_entry_callback
argument of
• You can write a callback function that is invoked when the search operation
normally sends LDAP v3 search result references.
This function must have the prototype specified by
plugin_referral_entry_callback
argument of
arbitrary plug-in or operation-specific data to these callback functions. Specify
the data that you want to pass as the
slapi_search_internal_callback_pb()
Memory Concerns
The entries passed to the search entry callback function do not need to be freed. If
you need to access an entry after returning from the callback function, call
slapi_entry_dup()
The referral URLs passed to the referral entry callback function do not need to be
freed. If you need to access a referral string after returning from the callback
function, call
You do not need to call
slapi_search_internal_callback_pb()
slapi_search_internal_get_entry()
Performs an internal search operation to read one entry (that is, it performs a base
object search).
Syntax
#include "slapi-plugin.h"
int slapi_search_internal_get_entry( Slapi_DN *dn,
char ** attrlist, Slapi_Entry **ret_entry, void *caller_identity);
Parameters
This function takes the following parameter:
dn
attrlist
230 Netscape Directory Server Plug-In Programmer's Guide • December 2003
slapi_search_internal_callback_pb()
slapi_search_internal_callback_pb()
to make a copy.
slapi_ch_strdup()
slapi_free_search_results_internal()
The DN of the entry to be read.
A NULL terminated array of attribute types to return from
entries that match filter. If you specify a NULL, all attributes will
be returned.
. You specify this function in the
. You specify this function in the
callback_data
.
to make a copy.
.
psec
.
prec
. You can also pass
argument of
after calling