ldap_next_entry

Returns a pointer to the next entry of message type, LDAP_RES_SEARCH_ENTRY, in chain of LDAPMessage structures.

LDAP Version:v2 or higher

Library:*ldapsdk.*

NDS Version:7.xx or higher

Platform:NLM, Windows (NT, 95, 98, 2000, XP, Vista 32-bit and 64-bit ), Linux (32-bit and 64-bit), Solaris, AIX, and HP-UX

Syntax

  #include <ldap.h>
  
  LDAPMessage *ldap_next_entry (
     LDAP          *ld,
     LDAPMessage   *entry);

ld: (IN) Points to the handle for the LDAP session.
entry: (IN/OUT) Points to the next LDAPMessage structure in the chain. On the first call, this is the value returned by the ldap_first_entry function. On subsequent calls, it is the value returned by the ldap_next_entry function.

NULL	No more entries in the chain or failure
>0	Pointer to the next entry in the chain

If the ldap_next_entry function encounters an error, the function returns NULL and sets the LDAP_OPT_RESULT_CODE option in the LDAP session handle.

Use the ldap_get_dn, ldap_first_attribute, ldap_get_values functions to retrieve information about the entry.