1 .TH LDAP_FIRST_ENTRY 3 "25 November 1994" "U-M LDAP LDVERSION"
3 ldap_first_entry, ldap_next_entry, ldap_count_entries \- LDAP result entry parsing and counting routines
11 ldap_count_entries(ld, result)
17 LDAPMessage *ldap_first_entry(ld, result)
23 LDAPMessage *ldap_next_entry(ld, entry)
29 These routines are used to parse results received from
31 or the synchronous LDAP search operation routines
34 .BR ldap_search_st (3).
38 routine is used to retrieve the first entry in a chain
39 of search results. It takes the \fIresult\fP as returned by a call to
44 .BR ldap_search_st (3)
45 and returns a pointer to the first entry in the result.
47 This pointer should be supplied on a subsequent call to
49 to get the next entry, the result of which should be
50 supplied to the next call to
51 .BR ldap_next_entry() ,
54 will return NULL when there are no more entries. The entries returned
55 from these calls are used in calls to the routines described in
57 .BR ldap_first_attribute (3),
58 .BR ldap_get_values (3),
61 A count of the number of entries in the search result can be obtained
63 .BR ldap_count_entries() .
68 .BR ldap_next_entry() ,
69 NULL is returned and the ld_errno field in the \fIld\fP parameter
70 is set to indicate the error. If an error occurs in
71 .BR ldap_count_entries() ,
74 is set appropriately. See
76 for a description of possible error codes.
81 .BR ldap_first_attribute(3),
82 .BR ldap_get_values(3),