ldapFirstEntry(3ibx) — Subroutines
NAME
ldapFirstEntry − Returns the address of the first entry from an initialized chain of directory entries.
SYNOPSIS
| #include <libldap.h> | ||
| LDAPM_T ∗ ldapFirstEntry( | LDAP_t ∗ldap_handle, | |
| LDAPM_t ∗entry_chain ); |
MODIFIED PARAMETER
ldap_handleThe address of an LDAP handle; this call modifies the handle so that a subsequent call to the ldapNextEntry function succeeds.
INPUT PARAMETER
entry_chainA chain of directory entries initialized by a call to the ldapSearchReqst, the ldapSearchReqstLim, the ldapSearchW, or the ldapSearchWLim function.
DESCRIPTION
Call one of the ldapSearch functions to initialize a chain of directory entries. Then, obtain the address of the first entry in the chain by calling the ldapFirstEntry function. Finally, call the ldapNextEntry function as often as is necessary to obtain the addresses of the remaining entries in the chain.
RETURNS
The address of the first directory entry in the chain, or NULL, if there are no entries in the chain.
RELATED INFORMATION
Functions: ldapFirstAttribute(3), ldapNextEntry(3), ldapSearchReqst(3), ldapSearchReqstLim(3), ldapSearchW(3), ldapSearchWLim(3).