NAME

ldap_get_values, ldap_get_values_len, ldap_count_values - LDAP attribute value handling routines

LIBRARY

OpenLDAP LDAP (libldap, -lldap)

SYNOPSIS


##iinncclluuddee <>
<>
        <>
<>
cchhaarr ****llddaapp__ggeett__vvaalluueess((lldd,, eennttrryy,, aattttrr))
LLDDAAPP **lldd;;
LLDDAAPPMMeessssaaggee **eennttrryy;;
cchhaarr **aattttrr;;
<>
ssttrruucctt bbeerrvvaall ****llddaapp__ggeett__vvaalluueess__lleenn((lldd,, eennttrryy,, aattttrr))
LLDDAAPP **lldd;;
LLDDAAPPMMeessssaaggee **eennttrryy;;
cchhaarr **aattttrr;;
<>
iinntt llddaapp__ccoouunntt__vvaalluueess((vvaallss))
cchhaarr ****vvaallss;;
<>
iinntt llddaapp__ccoouunntt__vvaalluueess__lleenn((vvaallss))
ssttrruucctt bbeerrvvaall ****vvaallss;;
<>
vvooiidd llddaapp__vvaalluuee__ffrreeee((vvaallss))
cchhaarr ****vvaallss;;
<>
vvooiidd llddaapp__vvaalluuee__ffrreeee__lleenn((vvaallss))
ssttrruucctt bbeerrvvaall ****vvaallss;;
<> DDEESSCCRRIIPPTTIIOONN <>
TThheessee rroouuttiinneess aarree uusseedd ttoo rreettrriieevvee aanndd mmaanniippuullaattee aattttrriibbuuttee vvaalluueess
ffrroomm aann LLDDAAPP eennttrryy aass rreettuurrnneedd bbyy
<>llddaapp__ffiirrsstt__eennttrryy((33))<>
oorr
<>llddaapp__nneexxtt__eennttrryy((33))<>
<>llddaapp__ggeett__vvaalluueess(())<>
ttaakkeess tthhee _e_n_t_r_y aanndd tthhee aattttrriibbuuttee _a_t_t_r
wwhhoossee vvaalluueess aarree ddeessiirreedd aanndd rreettuurrnnss aa NNUULLLL--tteerrmmiinnaatteedd aarrrraayy ooff tthhee
aattttrriibbuuttee''ss vvaalluueess..  _a_t_t_r mmaayy bbee aann aattttrriibbuuttee ttyyppee aass rreettuurrnneedd
ffrroomm
<>llddaapp__ffiirrsstt__aattttrriibbuuttee((33))<>
oorr
<>llddaapp__nneexxtt__aattttrriibbuuttee((33))<>
oorr iiff tthhee aattttrriibbuuttee ttyyppee iiss kknnoowwnn iitt ccaann ssiimmppllyy bbee ggiivveenn..
<>
TThhee nnuummbbeerr ooff vvaalluueess iinn tthhee aarrrraayy ccaann bbee ccoouunntteedd bbyy ccaalllliinngg
<>llddaapp__ccoouunntt__vvaalluueess(())<>..
TThhee aarrrraayy ooff vvaalluueess rreettuurrnneedd ccaann bbee ffrreeeedd bbyy ccaalllliinngg
<>llddaapp__vvaalluuee__ffrreeee(())<>..
<>
IIff tthhee aattttrriibbuuttee vvaalluueess aarree bbiinnaarryy iinn nnaattuurree,, aanndd tthhuuss nnoott ssuuiittaabbllee
ttoo bbee rreettuurrnneedd aass aann aarrrraayy ooff cchhaarr **''ss,, tthhee
<>llddaapp__ggeett__vvaalluueess__lleenn(())<>
rroouuttiinnee ccaann bbee uusseedd iinnsstteeaadd..  IItt ttaakkeess tthhee ssaammee ppaarraammeetteerrss aass
<>llddaapp__ggeett__vvaalluueess(())<>,,
bbuutt rreettuurrnnss aa NNUULLLL--tteerrmmiinnaatteedd aarrrraayy ooff ppooiinntteerrss
ttoo bbeerrvvaall ssttrruuccttuurreess,, eeaacchh ccoonnttaaiinniinngg tthhee lleennggtthh ooff aanndd aa ppooiinntteerr
ttoo aa vvaalluuee..
<>
TThhee nnuummbbeerr ooff vvaalluueess iinn tthhee aarrrraayy ccaann bbee ccoouunntteedd bbyy ccaalllliinngg
<>llddaapp__ccoouunntt__vvaalluueess__lleenn(())<>..
TThhee aarrrraayy ooff vvaalluueess rreettuurrnneedd ccaann bbee ffrreeeedd bbyy ccaalllliinngg
<>llddaapp__vvaalluuee__ffrreeee__lleenn(())<>..
<> EERRRROORRSS <>
IIff aann eerrrroorr ooccccuurrss iinn
<>llddaapp__ggeett__vvaalluueess(())<>
oorr
<>llddaapp__ggeett__vvaalluueess__lleenn(())<>,,
NNUULLLL iiss rreettuurrnneedd aanndd tthhee
<>lldd__eerrrrnnoo<>
ffiieelldd iinn tthhee _l_d ppaarraammeetteerr iiss sseett ttoo
iinnddiiccaattee tthhee eerrrroorr..  SSeeee
<>llddaapp__eerrrroorr((33))<>
ffoorr aa ddeessccrriippttiioonn ooff ppoossssiibbllee eerrrroorr ccooddeess..
<> NNOOTTEESS <>
TThheessee rroouuttiinneess ddyynnaammiiccaallllyy aallllooccaattee mmeemmoorryy wwhhiicchh tthhee ccaalllleerr mmuusstt ffrreeee
uussiinngg tthhee ssuupppplliieedd rroouuttiinneess..
<> SSEEEE AALLSSOO <>
<>llddaapp((33))<>
<>llddaapp__ffiirrsstt__eennttrryy((33))<>
<>llddaapp__ffiirrsstt__aattttrriibbuuttee((33))<>
<>llddaapp__eerrrroorr((33))<>
<> AACCKKNNOOWWLLEEDDGGEEMMEENNTTSS <>
<>OOppeennLLDDAAPP SSooffttwwaarree<>
iiss ddeevveellooppeedd aanndd mmaaiinnttaaiinneedd bbyy TThhee OOppeennLLDDAAPP PPrroojjeecctt <>..
<>OOppeennLLDDAAPP SSooffttwwaarree<>
iiss ddeerriivveedd ffrroomm UUnniivveerrssiittyy ooff MMiicchhiiggaann LLDDAAPP 33..33 RReelleeaassee..
<>
<>