NAME

ldap_abandon_ext - Abandon an LDAP operation in progress

LIBRARY

OpenLDAP LDAP (libldap, -lldap)

SYNOPSIS



#include 

iinntt llddaapp__aabbaannddoonn__eexxtt(( LLDDAAPP **_l_d,, BBiinntt _m_s_g_i_d,, LLDDAAPPCCoonnttrrooll ****_s_c_t_r_l_s,, LLDDAAPPCCoonnttrrooll ****_c_c_t_r_l_s ));; <> DDEESSCCRRIIPPTTIIOONN <> TThhee <>llddaapp__aabbaannddoonn__eexxtt(())<> rroouuttiinnee iiss uusseedd ttoo sseenndd aa LLDDAAPP AAbbaannddoonn rreeqquueesstt ffoorr aann ooppeerraattiioonn iinn pprrooggrreessss.. TThhee _m_s_g_i_d ppaasssseedd sshhoouulldd bbee tthhee mmeessssaaggee iidd ooff aann oouuttssttaannddiinngg LLDDAAPP ooppeerraattiioonn,, ssuucchh aass rreettuurrnneedd bbyy <>llddaapp__sseeaarrcchh__eexxtt((33))<> <> <>llddaapp__aabbaannddoonn__eexxtt<>(()) cchheecckkss ttoo sseeee iiff tthhee rreessuulltt ooff tthhee ooppeerraattiioonn hhaass aallrreeaaddyy ccoommee iinn.. IIff iitt hhaass,, iitt ddeelleetteess iitt ffrroomm tthhee qquueeuuee ooff ppeennddiinngg mmeessssaaggeess.. IIff nnoott,, iitt sseennddss aann LLDDAAPP aabbaannddoonn rreeqquueesstt ttoo tthhee LLDDAAPP sseerrvveerr.. <> TThhee ccaalllleerr ccaann eexxppeecctt tthhaatt tthhee rreessuulltt ooff aann aabbaannddoonneedd ooppeerraattiioonn wwiillll nnoott bbee rreettuurrnneedd ffrroomm aa ffuuttuurree ccaallll ttoo <>llddaapp__rreessuulltt((33))<> <> <>llddaapp__aabbaannddoonn__eexxtt(())<> aalllloowwss sseerrvveerr aanndd cclliieenntt ccoonnttrroollss ttoo bbee ppaasssseedd iinn vviiaa tthhee <>ssccttrrllss<> aanndd <>ccccttrrllss<> ppaarraammeetteerrss,, rreessppeeccttiivveellyy.. <> <>llddaapp__aabbaannddoonn__eexxtt(())<> rreettuurrnnss aa ccooddee iinnddiiccaattiinngg ssuucccceessss oorr,, iinn tthhee ccaassee ooff ffaaiilluurree,, tthhee nnaattuurree ooff tthhee ffaaiilluurree.. SSeeee <>llddaapp__eerrrroorr((33))<> ffoorr ddeettaaiillss.. <> DDEEPPRREECCAATTEEDD IINNTTEERRFFAACCEESS <> TThhee <>llddaapp__aabbaannddoonn(())<> rroouuttiinnee iiss ddeepprreeccaatteedd iinn ffaavvoorr ooff tthhee <>llddaapp__aabbaannddoonn__eexxtt(())<> rroouuttiinnee.. <> DDeepprreeccaatteedd iinntteerrffaacceess ggeenneerraallllyy rreemmaaiinn iinn tthhee lliibbrraarryy.. TThhee mmaaccrroo LLDDAAPP__DDEEPPRREECCAATTEEDD ccaann bbee ddeeffiinneedd ttoo aa nnoonn--zzeerroo vvaalluuee ((ee..gg..,, --DDLLDDAAPP__DDEEPPRREECCAATTEEDD==11)) wwhheenn ccoommppiilliinngg pprrooggrraamm ddeessiiggnneedd ttoo uussee ddeepprreeccaatteedd iinntteerrffaacceess.. IItt iiss rreeccoommmmeennddeedd tthhaatt ddeevveellooppeerrss wwrriittiinngg nneeww pprrooggrraammss,, oorr uuppddaattiinngg oolldd pprrooggrraammss,, aavvooiidd uussee ooff ddeepprreeccaatteedd iinntteerrffaacceess.. OOvveerr ttiimmee,, iitt iiss eexxppeecctteedd tthhaatt ddooccuummeennttaattiioonn ((aanndd,, eevveennttuuaallllyy,, ssuuppppoorrtt)) ffoorr ddeepprreeccaatteedd iinntteerrffaacceess ttoo bbee eelliimmiinnaatteedd.. <> <> SSEEEE AALLSSOO <> <>llddaapp((33))<> <>llddaapp__eerrrroorr((33))<> <>llddaapp__rreessuulltt((33))<> <>llddaapp__sseeaarrcchh__eexxtt((33))<> <> AACCKKNNOOWWLLEEDDGGEEMMEENNTTSS <> <>OOppeennLLDDAAPP SSooffttwwaarree<> iiss ddeevveellooppeedd aanndd mmaaiinnttaaiinneedd bbyy TThhee OOppeennLLDDAAPP PPrroojjeecctt <>.. <>OOppeennLLDDAAPP SSooffttwwaarree<> iiss ddeerriivveedd ffrroomm UUnniivveerrssiittyy ooff MMiicchhiiggaann LLDDAAPP 33..33 RReelleeaassee.. <> <> <>