Stepping_Through_a_List_of_Entries

   The ldap_first_entry() and ldap_next_entry()  functions are
   used to step through and retrieve the list of entries from a
   search result chain. The ldap_first_reference() and ldap_next_
   reference() functions are used to step through and retrieve the
   list of continuation references from a search result chain. The
   ldap_count_entries() function is used to count the number of
   entries returned. The ldap_count_references() function is used to
   count the number of references returned.

    LDAPMessage *ldap_first_entry( LDAP *ld, LDAPMessage *res );

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

    LDAPMessage *ldap_first_reference( LDAP *ld, LDAPMessage *res );

    LDAPMessage *ldap_next_reference( LDAP *ld, LDAPMessage *ref );

    int ldap_count_entries( LDAP *ld, LDAPMessage *res );

    int ldap_count_references( LDAP *ld, LDAPMessage *res );

   Parameters are as follows:

   ld    The session handle.
   res   The search result, as obtained by a call to one of the
         synchronous search functions or ldap_result().
   entry The entry returned by a previous call to ldap_first_
         entry()  or ldap_next_entry().

   The ldap_first_entry() and ldap_next_entry()  functions will
   return NULL when no more entries or references exist in the
   result set to be returned. NULL is also returned if an error
   occurs while stepping through the entries, in which case the
   error parameters in the session handle ld will be set to indicate
   the error.

   The ldap_count_entries() function returns the number of entries
   contained in a chain of entries. It can also be used to count
   the number of entries that remain in a chain if called with a
   message, entry or reference returned by ldap_first_message(),
   ldap_next_message(), ldap_first_entry(),  ldap_next_entry(),
   ldap_first_reference(), ldap_next_reference().

   The ldap_count_references() function returns the number of
   references contained in a chain of search results. It can also be
   used to count the number of references that remain in a chain.