NAME

ldap_first_reference, ldap_next_reference, ldap_count_references - Stepping through continuation references in a result chain

LIBRARY

OpenLDAP LDAP (libldap, -lldap)

SYNOPSIS


##iinncclluuddee <>
<>
<>
iinntt llddaapp__ccoouunntt__rreeffeerreenncceess(( LLDDAAPP **lldd,, LLDDAAPPMMeessssaaggee **rreessuulltt ))
<>
LLDDAAPPMMeessssaaggee **llddaapp__ffiirrsstt__rreeffeerreennccee(( LLDDAAPP **lldd,, LLDDAAPPMMeessssaaggee **rreessuulltt ))
<>
LLDDAAPPMMeessssaaggee **llddaapp__nneexxtt__rreeffeerreennccee(( LLDDAAPP **lldd,, LLDDAAPPMMeessssaaggee **rreeffeerreennccee ))
<> DDEESSCCRRIIPPTTIIOONN <>
<>
TThheessee rroouuttiinneess aarree uusseedd ttoo sstteepp tthhrroouugghh tthhee ccoonnttiinnuuaattiioonn rreeffeerreenncceess iinn aa
rreessuulltt cchhaaiinn rreecceeiivveedd ffrroomm
<>llddaapp__rreessuulltt((33))<>
oorr tthhee ssyynncchhrroonnoouuss LLDDAAPP sseeaarrcchh ooppeerraattiioonn rroouuttiinneess..
<>
TThhee
<>llddaapp__ffiirrsstt__rreeffeerreennccee(())<>
rroouuttiinnee iiss uusseedd ttoo rreettrriieevvee tthhee ffiirrsstt rreeffeerreennccee 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 rreeffeerreennccee mmeessssaaggee iinn tthhee
rreessuulltt cchhaaiinn..
<>
TThhiiss ppooiinntteerr sshhoouulldd bbee ssuupppplliieedd oonn aa ssuubbsseeqquueenntt ccaallll ttoo
<>llddaapp__nneexxtt__rreeffeerreennccee(())<>
ttoo ggeett tthhee nneexxtt rreeffeerreennccee mmeessssaaggee,, tthhee rreessuulltt ooff wwhhiicchh sshhoouulldd bbee
ssuupppplliieedd ttoo tthhee nneexxtt ccaallll ttoo
<>llddaapp__nneexxtt__rreeffeerreennccee(())<>,,
eettcc..
<>llddaapp__nneexxtt__rreeffeerreennccee(())<>
wwiillll rreettuurrnn NNUULLLL wwhheenn tthheerree aarree nnoo mmoorree rreeffeerreennccee mmeessssaaggeess..
TThhee rreeffeerreennccee mmeessssaaggeess rreettuurrnneedd ffrroomm tthheessee ccaallllss aarree uusseedd bbyy
<>llddaapp__ppaarrssee__rreeffeerreennccee((33))<>
ttoo eexxttrraacctt rreeffeerrrraallss aanndd ccoonnttrroollss..
<>
AA ccoouunntt ooff tthhee nnuummbbeerr ooff rreeffeerreennccee mmeessssaaggeess iinn tthhee sseeaarrcchh rreessuulltt ccaann bbee
oobbttaaiinneedd bbyy ccaalllliinngg
<>llddaapp__ccoouunntt__rreeffeerreenncceess(())<>..
IItt ccaann aallssoo bbee uusseedd ttoo ccoouunntt tthhee nnuummbbeerr ooff rreeffeerreennccee mmeessssaaggeess rreemmaaiinniinngg
iinn aa rreessuulltt cchhaaiinn..
<> EERRRROORRSS <>
IIff aann eerrrroorr ooccccuurrss iinn
<>llddaapp__ffiirrsstt__rreeffeerreennccee(())<>
oorr
<>llddaapp__nneexxtt__rreeffeerreennccee(())<>,,
NNUULLLL iiss rreettuurrnneedd..  IIff aann eerrrroorr ooccccuurrss iinn
<>llddaapp__ccoouunntt__rreeffeerreenncceess(())<>,,
--11 iiss rreettuurrnneedd..
<> SSEEEE AALLSSOO <>
<>llddaapp((33))<>
<>llddaapp__rreessuulltt((33))<>
<>llddaapp__sseeaarrcchh((33))<>
<>llddaapp__ppaarrssee__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..
<>
<>