NAME

ldap_parse_result - Parsing results

LIBRARY

OpenLDAP LDAP (libldap, -lldap)

SYNOPSIS


##iinncclluuddee <>
<>
<>
iinntt llddaapp__ppaarrssee__rreessuulltt(( LLDDAAPP **lldd,, LLDDAAPPMMeessssaaggee **rreessuulltt,,
        iinntt **eerrrrccooddeepp,, cchhaarr ****mmaattcchheeddddnnpp,, cchhaarr ****eerrrrmmssggpp,,
        cchhaarr ******rreeffeerrrraallsspp,, LLDDAAPPCCoonnttrrooll ******sseerrvveerrccttrrllsspp,,
        iinntt ffrreeeeiitt ))
<>
iinntt llddaapp__ppaarrssee__ssaassll__bbiinndd__rreessuulltt(( LLDDAAPP **lldd,, LLDDAAPPMMeessssaaggee **rreessuulltt,,
        ssttrruucctt bbeerrvvaall ****sseerrvveerrccrreeddpp,, iinntt ffrreeeeiitt ))
<>
iinntt llddaapp__ppaarrssee__eexxtteennddeedd__rreessuulltt(( LLDDAAPP **lldd,, LLDDAAPPMMeessssaaggee **rreessuulltt,,
        cchhaarr ****rreettooiiddpp,, ssttrruucctt bbeerrvvaall ****rreettddaattaapp,, iinntt ffrreeeeiitt ))
<> DDEESSCCRRIIPPTTIIOONN <>
<>
TThheessee rroouuttiinneess aarree uusseedd ttoo eexxttrraacctt iinnffoorrmmaattiioonn ffrroomm aa rreessuulltt mmeessssaaggee..
TThheeyy wwiillll ooppeerraattee oonn tthhee ffiirrsstt rreessuulltt mmeessssaaggee iinn aa cchhaaiinn ooff sseeaarrcchh
rreessuullttss ((sskkiippppiinngg ppaasstt ootthheerr mmeessssaaggee ttyyppeess)).. TThheeyy ttaakkee 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))<>
IInn aaddddiittiioonn ttoo
<>llddaapp__ppaarrssee__rreessuulltt(())<>,,
tthhee rroouuttiinneess
<>llddaapp__ppaarrssee__ssaassll__bbiinndd__rreessuulltt(())<>
aanndd
<>llddaapp__ppaarrssee__eexxtteennddeedd__rreessuulltt(())<>
aarree uusseedd ttoo ggeett aallll tthhee rreessuulltt iinnffoorrmmaattiioonn ffrroomm SSAASSLL bbiinndd aanndd eexxtteennddeedd
ooppeerraattiioonnss..
<>
TThhee _e_r_r_c_o_d_e_p ppaarraammeetteerr wwiillll bbee ffiilllleedd iinn wwiitthh tthhee rreessuulltt ccooddee ffrroomm
tthhee rreessuulltt mmeessssaaggee..
<>
TThhee sseerrvveerr mmiigghhtt ssuuppppllyy aa mmaattcchheedd DDNN ssttrriinngg iinn tthhee mmeessssaaggee iinnddiiccaattiinngg
hhooww mmuucchh ooff aa nnaammee iinn aa rreeqquueesstt wwaass rreeccooggnniizzeedd.. TThhee _m_a_t_c_h_e_d_d_n_p
ppaarraammeetteerr wwiillll bbee ffiilllleedd iinn wwiitthh tthhiiss ssttrriinngg iiff ssuupppplliieedd,, eellssee iitt wwiillll
bbee NNUULLLL.. IIff aa ssttrriinngg iiss rreettuurrnneedd,, iitt sshhoouulldd bbee ffrreeeedd uussiinngg
<>llddaapp__mmeemmffrreeee((33))<>
<>
TThhee _e_r_r_m_s_g_p ppaarraammeetteerr wwiillll bbee ffiilllleedd iinn wwiitthh tthhee eerrrroorr mmeessssaaggee
ffiieelldd ffrroomm tthhee ppaarrsseedd mmeessssaaggee.. TThhiiss ssttrriinngg sshhoouulldd bbee ffrreeeedd uussiinngg
<>llddaapp__mmeemmffrreeee((33))<>
<>
TThhee _r_e_f_e_r_r_a_l_s_p ppaarraammeetteerr wwiillll bbee ffiilllleedd iinn wwiitthh aann aallllooccaatteedd aarrrraayy ooff
rreeffeerrrraall ssttrriinnggss ffrroomm tthhee ppaarrsseedd mmeessssaaggee.. TThhiiss aarrrraayy sshhoouulldd bbee ffrreeeedd uussiinngg
<>llddaapp__mmeemmvvffrreeee((33))<>
IIff nnoo rreeffeerrrraallss wweerree rreettuurrnneedd,, _*_r_e_f_e_r_r_a_l_s_p iiss sseett ttoo NNUULLLL..
<>
TThhee _s_e_r_v_e_r_c_t_r_l_s_p ppaarraammeetteerr wwiillll bbee ffiilllleedd iinn wwiitthh aann aallllooccaatteedd aarrrraayy ooff
ccoonnttrroollss ccooppiieedd ffrroomm tthhee ppaarrsseedd mmeessssaaggee.. TThhee aarrrraayy sshhoouulldd bbee ffrreeeedd uussiinngg
<>llddaapp__ccoonnttrroollss__ffrreeee((33))<>
IIff nnoo ccoonnttrroollss wweerree rreettuurrnneedd,, _*_s_e_r_v_e_r_c_t_r_l_s_p iiss sseett ttoo NNUULLLL..
<>
TThhee _f_r_e_e_i_t ppaarraammeetteerr ddeetteerrmmiinneess wwhheetthheerr tthhee ppaarrsseedd mmeessssaaggee iiss
ffrreeeedd oorr nnoott aafftteerr tthhee eexxttrraaccttiioonn.. AAnnyy nnoonn--zzeerroo vvaalluuee wwiillll mmaakkee iitt
ffrreeee tthhee mmeessssaaggee.. TThhee
<>llddaapp__mmssggffrreeee((33))<>
rroouuttiinnee ccaann aallssoo bbee uusseedd ttoo ffrreeee tthhee mmeessssaaggee llaatteerr..
<>
FFoorr SSAASSLL bbiinndd rreessuullttss,, tthhee _s_e_r_v_e_r_c_r_e_d_p ppaarraammeetteerr wwiillll bbee ffiilllleedd iinn
wwiitthh aann aallllooccaatteedd bbeerrvvaall ssttrruuccttuurree ccoonnttaaiinniinngg tthhee ccrreeddeennttiiaallss ffrroomm tthhee
sseerrvveerr iiff pprreesseenntt.. TThhee ssttrruuccttuurree sshhoouulldd bbee ffrreeeedd uussiinngg
<>bbeerr__bbvvffrreeee((33))<>
<>
FFoorr eexxtteennddeedd rreessuullttss,, tthhee _r_e_t_o_i_d_p ppaarraammeetteerr wwiillll bbee ffiilllleedd iinn
wwiitthh tthhee ddootttteedd--OOIIDD tteexxtt rreepprreesseennttaattiioonn ooff tthhee nnaammee ooff tthhee eexxtteennddeedd
ooppeerraattiioonn rreessppoonnssee.. TThhee ssttrriinngg sshhoouulldd bbee ffrreeeedd uussiinngg
<>llddaapp__mmeemmffrreeee((33))<>
IIff nnoo OOIIDD wwaass rreettuurrnneedd,, _*_r_e_t_o_i_d_p iiss sseett ttoo NNUULLLL..
<>
FFoorr eexxtteennddeedd rreessuullttss,, tthhee _r_e_t_d_a_t_a_p ppaarraammeetteerr wwiillll bbee ffiilllleedd iinn
wwiitthh aa ppooiinntteerr ttoo aa bbeerrvvaall ssttrruuccttuurree ccoonnttaaiinniinngg tthhee ddaattaa ffrroomm tthhee
eexxtteennddeedd ooppeerraattiioonn rreessppoonnssee.. TThhee ssttrruuccttuurree sshhoouulldd bbee ffrreeeedd uussiinngg
<>bbeerr__bbvvffrreeee((33))<>
IIff nnoo ddaattaa wweerree rreettuurrnneedd,, _*_r_e_t_d_a_t_a_p iiss sseett ttoo NNUULLLL..
<>
FFoorr aallll tthhee aabboovvee rreessuulltt ppaarraammeetteerrss,, NNUULLLL vvaalluueess ccaann bbee uusseedd iinn ccaallllss
iinn oorrddeerr ttoo iiggnnoorree cceerrttaaiinn ffiieellddss..
<> EERRRROORRSS <>
UUppoonn ssuucccceessss LLDDAAPP__SSUUCCCCEESSSS iiss rreettuurrnneedd.. OOtthheerrwwiissee tthhee vvaalluueess ooff tthhee
rreessuulltt ppaarraammeetteerrss aarree uunnddeeffiinneedd..
<> SSEEEE AALLSSOO <>
<>llddaapp((33))<>
<>llddaapp__rreessuulltt((33))<>
<>llddaapp__sseeaarrcchh((33))<>
<>llddaapp__mmeemmffrreeee((33))<>
<>llddaapp__mmeemmvvffrreeee((33))<>
<>llddaapp__ggeett__vvaalluueess((33))<>
<>llddaapp__ccoonnttrroollss__ffrreeee((33))<>
<>llbbeerr--ttyyppeess((33))<>
<> AACCKKNNOOWWLLEEDDGGEEMMEENNTTSS <>
<>OOppeennLLDDAAPP SSooffttwwaarree<>
iiss ddeevveellooppeedd aanndd mmaaiinnttaaiinneedd bbyy TThhee OOppeennLLDDAAPP PPrroojjeecctt <>..
<>OOppeennLLDDAAPP SSooffttwwaarree<>
iiss ddeerriivveedd ffrroomm UUnniivveerrssiittyy ooff MMiicchhiiggaann LLDDAAPP 33..33 RReelleeaassee..
<>
<>