/usr/man/cat.3/ldap_abandon_ext.3.Z(/usr/man/cat.3/ldap_abandon_ext.3.Z)

     LDAP_ABANDON(3)          OpenLDAP 2.1.12          LDAP_ABANDON(3)

     NAME
          ldap_abandon, ldap_abandon_ext - Abandon an LDAP operation
          in progress

     LIBRARY
          OpenLDAP LDAP (libldap, -lldap)

     SYNOPSIS
          #include <ldap.h>

          int ldap_abandon(LDAP *ld, int msgid);

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

     DESCRIPTION
          The ldap_abandon() routine is used to abandon or cancel an
          LDAP operation in progress.  The msgid passed should be the
          message id of an outstanding LDAP operation, as returned by
          ldap_search(3), ldap_modify(3), etc.

          ldap_abandon() 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
          ldap_result(3).

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

     ERRORS
          ldap_abandon() returns 0 if everything goes ok, -1
          otherwise, setting ld_errno with an appropriate LDAP error
          code.

          ldap_abandon_ext() directly returns an LDAP error code
          indicating success or failure of the operation.

          See ldap_error(3) for details.

     SEE ALSO
          ldap(3), ldap_result(3), ldap_error(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.

     Page 1                                         (printed 1/20/103)

See also ldap_abandon(3):  man 3 ldap_abandon