next_entry Function

This function iterates to the next entry in the result set of a search operation.

Syntax

DBMS_LDAP.next_entry (

ld  IN SESSION,
msg  IN MESSAGE )

RETURN MESSAGE;

Parameters

Table 20-28 next_entry Function Parameters

Parameter	Description
ld (IN)	A valid LDAP session handle.
msg (IN)	The search result, as obtained by a call to one of the synchronous search routines.

Return Values

Table 20-29 next_entry Function Return Values

Value	Description
MESSAGE	A handle to the next entry in the list of entries returned from the LDAP server. It is set to NULL if there was an error and an exception is raised.

Exceptions

Table 20-30 next_entry Function Exceptions

Exception	Description
invalid_session	Raised if the session handle, ld is invalid.
invalid_message	Raised if the incoming msg handle is invalid.

Usage Notes

The function next_entry should always be called after a call to first_entry. Also, the return value of a successful call to next_entry should be used as msg argument used in a subsequent call to next_entry to fetch the next entry in the list.

See Also: "search_s Function" "search_st Function" "first_entry Function"