ldap_next_entry()--Retrieve Next LDAP Entry

 #include <ldap.h>

 LDAPMessage *ldap_next_entry(
                LDAP         *ld,
                LDAPMessage  *entry)

The ldap_next_entry() function takes the result from a previous call to ldap_first_entry() or ldap_next_entry() and returns a pointer to the next entry in a chain of results.

The entry returned by ldap_next_entry() can be used by functions such as ldap_get_dn(), ldap_first_attribute(), and ldap_get_values(), as well as other functions to obtain additional information about the entry.

Authorities and Locks

No IBM^® i authority is required.

Parameters

ld

(Input) Specifies the LDAP pointer returned by a previous call to ldap_init(), ldap_ssl_init(), or ldap_open().

entry

(Input) Specifies a pointer to an entry returned on a previous call to ldap_first_entry() or ldap_next_entry().

Return Value

Pointer to the next entry in the result

if the request was successful.

NULL

When there are no attributes left to be retrieved.

Error Conditions

If ldap_next_entry() is not successful, NULL is returned, ld_errno will be set to indicate the error. See LDAP Client API Error Conditions for possible LDAP error code values. Use ldap_get_errno() function to retrieve the error information.

Error Messages

The following message may be sent from this function.

Related Information

• ldap_first_entry() -- Return first entry in a chain of search results.
• ldap_count_entries() -- Return number of entries in a chain of search results.
• ldap_get_entry_controls_np() -- Extract server controls from an entry.
• ldap_first_reference() -- Return first continuation reference in a chain of search results.
• ldap_next_reference() -- Return next continuation reference in a chain of search results.
• ldap_count_references() -- Return number of continuation reference in a chain of search results.
• ldap_parse_reference_np() -- Extract information from a continuation reference.

[ Back to top | LDAP APIs | APIs by category ]