NAME

ldap_first_entry, ldap_next_entry, ldap_count_entries - LDAP result entry parsing and counting routines

LIBRARY

OpenLDAP LDAP (libldap, -lldap)

SYNOPSIS


##iinncclluuddee <>
<>
<>
iinntt llddaapp__ccoouunntt__eennttrriieess(( LLDDAAPP **lldd,, LLDDAAPPMMeessssaaggee **rreessuulltt ))
<>
LLDDAAPPMMeessssaaggee **llddaapp__ffiirrsstt__eennttrryy(( LLDDAAPP **lldd,, LLDDAAPPMMeessssaaggee **rreessuulltt ))
<>
LLDDAAPPMMeessssaaggee **llddaapp__nneexxtt__eennttrryy(( LLDDAAPP **lldd,, LLDDAAPPMMeessssaaggee **eennttrryy ))
<> DDEESSCCRRIIPPTTIIOONN <>
<>
TThheessee rroouuttiinneess aarree uusseedd ttoo ppaarrssee rreessuullttss rreecceeiivveedd ffrroomm
<>llddaapp__rreessuulltt((33))<>
oorr tthhee ssyynncchhrroonnoouuss LLDDAAPP sseeaarrcchh ooppeerraattiioonn rroouuttiinneess
<>llddaapp__sseeaarrcchh__ss((33))<>
aanndd
<>llddaapp__sseeaarrcchh__sstt((33))<>
<>
TThhee
<>llddaapp__ffiirrsstt__eennttrryy(())<>
rroouuttiinnee iiss uusseedd ttoo rreettrriieevvee tthhee ffiirrsstt eennttrryy iinn aa cchhaaiinn
ooff sseeaarrcchh rreessuullttss..  IItt ttaakkeess tthhee _r_e_s_u_l_t aass rreettuurrnneedd bbyy aa ccaallll ttoo
<>llddaapp__rreessuulltt((33))<>
oorr
<>llddaapp__sseeaarrcchh__ss((33))<>
oorr
<>llddaapp__sseeaarrcchh__sstt((33))<>
aanndd rreettuurrnnss aa ppooiinntteerr ttoo tthhee ffiirrsstt eennttrryy iinn tthhee rreessuulltt..
<>
TThhiiss ppooiinntteerr sshhoouulldd bbee ssuupppplliieedd oonn aa ssuubbsseeqquueenntt ccaallll ttoo
<>llddaapp__nneexxtt__eennttrryy(())<>
ttoo ggeett tthhee nneexxtt eennttrryy,, tthhee rreessuulltt ooff wwhhiicchh sshhoouulldd bbee
ssuupppplliieedd ttoo tthhee nneexxtt ccaallll ttoo
<>llddaapp__nneexxtt__eennttrryy(())<>,,
eettcc..
<>llddaapp__nneexxtt__eennttrryy(())<>
wwiillll rreettuurrnn NNUULLLL wwhheenn tthheerree aarree nnoo mmoorree eennttrriieess..  TThhee eennttrriieess rreettuurrnneedd
ffrroomm tthheessee ccaallllss aarree uusseedd iinn ccaallllss ttoo tthhee rroouuttiinneess ddeessccrriibbeedd iinn
<>llddaapp__ggeett__ddnn((33))<>
<>llddaapp__ffiirrsstt__aattttrriibbuuttee((33))<>
<>llddaapp__ggeett__vvaalluueess((33))<>
eettcc..
<>
AA ccoouunntt ooff tthhee nnuummbbeerr ooff eennttrriieess iinn tthhee sseeaarrcchh rreessuulltt ccaann bbee oobbttaaiinneedd
bbyy ccaalllliinngg
<>llddaapp__ccoouunntt__eennttrriieess(())<>..
<> EERRRROORRSS <>
IIff aann eerrrroorr ooccccuurrss iinn
<>llddaapp__ffiirrsstt__eennttrryy(())<>
oorr
<>llddaapp__nneexxtt__eennttrryy(())<>,,
NNUULLLL iiss rreettuurrnneedd aanndd tthhee lldd__eerrrrnnoo ffiieelldd iinn tthhee _l_d ppaarraammeetteerr
iiss sseett ttoo iinnddiiccaattee tthhee eerrrroorr..  IIff aann eerrrroorr ooccccuurrss iinn
<>llddaapp__ccoouunntt__eennttrriieess(())<>,,
--11 iiss rreettuurrnneedd,, aanndd
<>lldd__eerrrrnnoo<>
iiss sseett aapppprroopprriiaatteellyy..  SSeeee
<>llddaapp__eerrrroorr((33))<>
ffoorr aa ddeessccrriippttiioonn ooff ppoossssiibbllee eerrrroorr ccooddeess..
<> SSEEEE AALLSSOO <>
<>llddaapp((33))<>
<>llddaapp__rreessuulltt((33))<>
<>llddaapp__sseeaarrcchh((33))<>
<>llddaapp__ffiirrsstt__aattttrriibbuuttee((33))<>
<>llddaapp__ggeett__vvaalluueess((33))<>
<>llddaapp__ggeett__ddnn((33))<>
<> AACCKKNNOOWWLLEEDDGGEEMMEENNTTSS <>
<>OOppeennLLDDAAPP SSooffttwwaarree<>
iiss ddeevveellooppeedd aanndd mmaaiinnttaaiinneedd bbyy TThhee OOppeennLLDDAAPP PPrroojjeecctt <>..
<>OOppeennLLDDAAPP SSooffttwwaarree<>
iiss ddeerriivveedd ffrroomm UUnniivveerrssiittyy ooff MMiicchhiiggaann LLDDAAPP 33..33 RReelleeaassee..
<>