LDAPABANDON(3) LDAPABANDON(3)

NAME
       ldapabandon, ldapabandonext - Abandon an LDAP operation in progress

LLIIBBRRAARRYY
       OpenLDAP LDAP (libldap, -lldap)

SYNOPSIS
       ##iinncclluuddee <>

       iinntt llddaappaabbaannddoonn((LLDDAAPP **ld,, iinntt msgid));;

       iinntt llddaappaabbaannddoonneexxtt((LLDDAAPP **ld,, iinntt msgid,,
              LLDDAAPPCCoonnttrrooll **sctrls[[]],, LLDDAAPPCCoonnttrrooll **cctrls[[]]));;

DESCRIPTION
       The  llddaappaabbaannddoonn(()) routine is used to abandon or cancel an LDAP opera-
       tion in progress.  The msgid passed should be the message id of an out-
       standing LDAP operation, as returned by llddaappsseeaarrcchh(3), llddaappmmooddiiffyy(3),
       etc.

       llddaappaabbaannddoonn() checks to see if the result of the operation has already
       come  in.  If it has, it deletes it from the queue of pending messages.
       If not, it sends an LDAP abandon operation to the the LDAP server.

       The caller can expect that the result of an  abandoned  operation  will
       not be returned from a future call to llddaapprreessuulltt(3).

       llddaappaabbaannddoonneexxtt(())  is  equivalent  to  llddaappaabbaannddoonn(())  except  that it
       allows server and client controls to be passed in  sctrls  and  cctrls,
       respectively.

EERRRROORRSS
       llddaappaabbaannddoonn(())  returns  0 if everything goes ok, -1 otherwise, setting
       lderrno with an appropriate LDAP error code.

       llddaappaabbaannddoonneexxtt(()) directly returns an LDAP error code indicating  suc-
       cess or failure of the operation.

       See llddaappeerrrroorr(3) for details.

SEE ALSO
       llddaapp(3), llddaapprreessuulltt(3), llddaappeerrrroorr(3)

AACCKKNNOOWWLLEEDDGGEEMMEENNTTSS
       OOppeennLLDDAAPP   is   developed   and  maintained  by  The  OpenLDAP  Project
       (http://www.openldap.org/).  OOppeennLLDDAAPP is  derived  from  University  of
       Michigan LDAP 3.3 Release.



OpenLDAP 2.2.19                   2004/11/26                   LDAPABANDON(3)