NAME

ldap_first_message, ldap_next_message, ldap_count_messages - Stepping through messages in a result chain

LIBRARY

OpenLDAP LDAP (libldap, -lldap)

SYNOPSIS


##iinncclluuddee <>
<>
<>
iinntt llddaapp__ccoouunntt__mmeessssaaggeess(( LLDDAAPP **lldd,, LLDDAAPPMMeessssaaggee **rreessuulltt ))
<>
LLDDAAPPMMeessssaaggee **llddaapp__ffiirrsstt__mmeessssaaggee(( LLDDAAPP **lldd,, LLDDAAPPMMeessssaaggee **rreessuulltt ))
<>
LLDDAAPPMMeessssaaggee **llddaapp__nneexxtt__mmeessssaaggee(( LLDDAAPP **lldd,, LLDDAAPPMMeessssaaggee **mmeessssaaggee ))
<> DDEESSCCRRIIPPTTIIOONN <>
<>
TThheessee rroouuttiinneess aarree uusseedd ttoo sstteepp tthhrroouugghh tthhee mmeessssaaggeess iinn aa rreessuulltt cchhaaiinn
rreecceeiivveedd ffrroomm
<>llddaapp__rreessuulltt((33))<>
FFoorr sseeaarrcchh ooppeerraattiioonnss,, tthhee rreessuulltt cchhaaiinn ccaann ccoonnttaaiinn rreeffeerrrraall,, eennttrryy
aanndd rreessuulltt mmeessssaaggeess.. TThhee
<>llddaapp__mmssggttyyppee((33))<>
ffuunnccttiioonn ccaann bbee uusseedd ttoo ddiissttiinngguuiisshh bbeettwweeeenn tthhee ddiiffffeerreenntt mmeessssaaggee ttyyppeess..
<>
TThhee
<>llddaapp__ffiirrsstt__mmeessssaaggee(())<>
rroouuttiinnee iiss uusseedd ttoo rreettrriieevvee tthhee ffiirrsstt mmeessssaaggee iinn aa rreessuulltt cchhaaiinn..
IItt ttaakkeess tthhee _r_e_s_u_l_t aass rreettuurrnneedd bbyy aa ccaallll ttoo
<>llddaapp__rreessuulltt((33))<>
<>llddaapp__sseeaarrcchh__ss((33))<>
oorr
<>llddaapp__sseeaarrcchh__sstt((33))<>
aanndd rreettuurrnnss aa ppooiinntteerr ttoo tthhee ffiirrsstt mmeessssaaggee iinn tthhee rreessuulltt cchhaaiinn..
<>
TThhiiss ppooiinntteerr sshhoouulldd bbee ssuupppplliieedd oonn aa ssuubbsseeqquueenntt ccaallll ttoo
<>llddaapp__nneexxtt__mmeessssaaggee(())<>
ttoo ggeett tthhee nneexxtt mmeessssaaggee,, tthhee rreessuulltt ooff wwhhiicchh sshhoouulldd bbee
ssuupppplliieedd ttoo tthhee nneexxtt ccaallll ttoo
<>llddaapp__nneexxtt__mmeessssaaggee(())<>,,
eettcc..
<>llddaapp__nneexxtt__mmeessssaaggee(())<>
wwiillll rreettuurrnn NNUULLLL wwhheenn tthheerree aarree nnoo mmoorree mmeessssaaggeess..
<>
TThheessee ffuunnccttiioonnss aarree uusseeffuull wwhheenn uussiinngg rroouuttiinneess lliikkee
<>llddaapp__ppaarrssee__rreessuulltt((33))<>
tthhaatt oonnllyy ooppeerraattee oonn tthhee ffiirrsstt rreessuulltt iinn tthhee cchhaaiinn..
<>
AA ccoouunntt ooff tthhee nnuummbbeerr ooff mmeessssaaggeess iinn tthhee rreessuulltt cchhaaiinn ccaann bbee oobbttaaiinneedd
bbyy ccaalllliinngg
<>llddaapp__ccoouunntt__mmeessssaaggeess(())<>..
IItt ccaann aallssoo bbee uusseedd ttoo ccoouunntt tthhee nnuummbbeerr ooff rreemmaaiinniinngg mmeessssaaggeess iinn aa cchhaaiinn
iiff ccaalllleedd wwiitthh aa mmeessssaaggee,, eennttrryy oorr rreeffeerreennccee rreettuurrnneedd bbyy
<>llddaapp__ffiirrsstt__mmeessssaaggee(()) ,,<>
<>llddaapp__nneexxtt__mmeessssaaggee(()) ,,<>
<>llddaapp__ffiirrsstt__eennttrryy((33))<>
<>llddaapp__nneexxtt__eennttrryy((33))<>
<>llddaapp__ffiirrsstt__rreeffeerreennccee((33))<>
<>llddaapp__nneexxtt__rreeffeerreennccee((33))<>
<> EERRRROORRSS <>
IIff aann eerrrroorr ooccccuurrss iinn
<>llddaapp__ffiirrsstt__mmeessssaaggee(())<>
oorr
<>llddaapp__nneexxtt__mmeessssaaggee(())<>,,
NNUULLLL iiss rreettuurrnneedd..  IIff aann eerrrroorr ooccccuurrss iinn
<>llddaapp__ccoouunntt__mmeessssaaggeess(())<>,,
--11 iiss rreettuurrnneedd..
<> SSEEEE AALLSSOO <>
<>llddaapp((33))<>
<>llddaapp__sseeaarrcchh((33))<>
<>llddaapp__rreessuulltt((33))<>
<>llddaapp__ppaarrssee__rreessuulltt((33))<>
<>llddaapp__ffiirrsstt__eennttrryy((33))<>
<>llddaapp__ffiirrsstt__rreeffeerreennccee((33))<>
<> AACCKKNNOOWWLLEEDDGGEEMMEENNTTSS <>
<>OOppeennLLDDAAPP SSooffttwwaarree<>
iiss ddeevveellooppeedd aanndd mmaaiinnttaaiinneedd bbyy TThhee OOppeennLLDDAAPP PPrroojjeecctt <>..
<>OOppeennLLDDAAPP SSooffttwwaarree<>
iiss ddeerriivveedd ffrroomm UUnniivveerrssiittyy ooff MMiicchhiiggaann LLDDAAPP 33..33 RReelleeaassee..
<>
<>