Netscape NETSCAPE DIRECTORY SERVER 6.2 - GATEWAY CUSTOMIZATION, Manual

Page: 83 / 612

Processing an LDAP Search Operation
Chapter 7 Defining Functions for LDAP Operations 83
The “next entry” function should get the next result specified in the set of results in
the parameter
SLAPI_SEARCH_RESULT_SET
. The function should set this next entry
as the value of the
SLAPI_SEARCH_RESULT_ENTRY
parameter in the parameter
block, and the “next entry” function should return 0 if successful.
The “next entry” function should set the
SLAPI_SEARCH_RESULT_ENTRY
parameter
to NULL and return -1 if one of the following situations occurs:
• The operation is abandoned (you can check this by calling the
slapi_op_abandoned()
function)
• The time limit has been exceeded
• The maximum number of entries has been exceeded
If no more entries exist in the set of results, the “next entry” function should set the
SLAPI_SEARCH_RESULT_ENTRY
parameter to NULL and return 0.
Parameter ID Data Type Description
SLAPI_SEARCH_RESULT_SET void *
Set of search results.
SLAPI_SEARCH_RESULT_ENTRY void *
Entry returned from iterating
through the results set. This
“next entry” function actually
sets this parameter.
SLAPI_SEARCH_RESULT_ENTRY_EXT void *
(Netscape Directory Server 4.x)
Reserved for future use.
The context identifying the last
result sent in the results set.
This “next entry” function
actually sets this parameter.
SLAPI_NENTRIES int
Number of search results found
SLAPI_SEARCH_REFERRALS struct
berval **
Array of the URLs to other
LDAP servers that the current
server is referring the client to