LDAPABANDON(3)                                                LDAPABANDON(3)



NAME
       ldapabandon, ldapabandonext - Abandon an LDAP operation in progress

LIBRARY
       OpenLDAP LDAP (libldap, -lldap)

SYNOPSIS
       ##include <>

       int ldapabandon(LDAP **ld,, int msgid);;

       int ldapabandonext(LDAP **ld,, int msgid,,
              LDAPControl **sctrls[],, LDAPControl **cctrls[]);;

DESCRIPTION
       The  ldapabandon() 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 ldapsearch(3), ldapmodify(3),
       etc.

       ldapabandon() 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 ldapresult(3).

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

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

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

       See ldaperror(3) for details.

SEE ALSO
       ldap(3), ldapresult(3), ldaperror(3)

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



OpenLDAP 2.2.19                   2004/11/26                   LDAPABANDON(3)